การแชร์สำหรับอุปกรณ์

ด้วยการแชร์สำหรับอุปกรณ์ ทำให้ผู้ใช้สามารถที่แชร์เนื้อหาจากอุปกรณ์ไปยัง Facebook ได้อย่างง่ายดาย ซึ่งรวมถึงสมาร์ททีวี กรอบรูปดิจิทัล หรืออุปกรณ์ทุกชนิดที่มีการเชื่อมต่ออินเตอร์เน็ต

ด้วยการแชร์สำหรับอุปกรณ์ อุปกรณ์ของคุณแสดงรหัสตัวอักษรผสมตัวเลข และแจ้งให้ผู้ใช้กรอกรหัสนั้นในหน้าเว็บบนคอมพิวเตอร์เดสก์ท็อปหรือสมาร์ทโฟน จากนั้นผู้ที่กำลังแอพของหรือการบริการของคุณจะสามารถแชร์เนื้อหาไปยัง Facebook ด้วย กล่องโต้ตอบการแชร์ ที่เชื่อมโยงกับรหัส

หากคุณกำลังสร้างแอพสำหรับ Apple TV หรืออุปกรณ์ Android คุณควรใช้ SDK สำหรับ tvOS หรือ SDK สำหรับ Android ตามลำดับ

คู่มือนี้จะแสดงข้อมูลต่อไปนี้

ประสบการณ์ผู้ใช้

1. การกระตุ้นให้ดำเนินการ

ก่อนอื่น ให้พิจารณาว่าคุณต้องการขอให้ผู้ใช้เข้าสู่ระบบหรือเชื่อมต่อกับ Facebook ในส่วนใดของประสบการณ์ เพื่อให้มีประสบการที่ดีที่สุด ให้ออกแบบปุ่มให้ดูเหมือนปุ่มเข้าสู่ระบบ Facebook อย่างเป็นทางการมากที่สุด โดยทั่วไปแล้ว ปุ่มควรอยู่ข้างเนื้อหาที่ต้องการแชร์

ถ้ามองในแง่มุมการออกแบบภาพ นั่นหมายความว่าคุณควร

  1. ติดฉลากที่ปุ่มด้วยคำว่า "แชร์" หรือ "แชร์ไปที่ Facebook"
  2. ใช้สีขาว และน้ำเงินซึ่งเป็นสีอย่างเป็นทางการของ Facebook: #3B5998
  3. หากอุปกรณ์ของคุณรองรับการแสดงผลแบบกราฟิก คุณสามารถใส่โลโก้ "f" อย่างเป็นทางการได้ โลโก้ควรเป็นสีขาวและน้ำเงินแบบ Facebook (#3B5998) ตาม แนวทางปฏิบัติเกี่ยวกับแบรนด์ของ Facebook

2. แสดงโค้ด

เมื่อผู้ใช้คลิกปุ่มกระตุ้นให้ดำเนินการ อุปกรณ์ของคุณจะเรียก API ของ Facebook ซึ่งส่งโค้ดกลับมา

ในอินเทอร์เฟซ ให้แจ้งผู้ใช้ว่าต้องไปที่เว็บไซต์และกรอกโค้ดด้วยข้อความนี้ “ขั้นต่อไป ให้ไปที่ facebook.com/device (http://facebook.com/device) บนเดสก์ท็อปหรือสมาร์ทโฟน แล้วกรอกโค้ดนี้" แสดงรหัสทั้งหมดที่คุณได้รับจาก API การเข้าสู่ระบบบนอุปกรณ์ของ Facebook โค้ดนี้จะมีความยาวอักขระ 6-12 ตัว

ให้ใส่ปุ่ม Close หรือ Done เพื่อให้ผู้ใช้ยกเลิกลำดับขั้นตอนการเข้าสู่ระบบบนอุปกรณ์

3. การแชร์

โฟลว์นี้คือโฟลว์ที่ผู้ใช้เห็นเมื่อไปที่ facebook.com/device จากเบราว์เซอร์บนเดสก์ท็อปหรือมือถือ ในขั้นแรก ผู้ใช้จะเห็นฟิลด์สำหรับข้อความที่สามารถกรอกโค้ดของตน

หลังจากที่กรอกรหัสและคลิก Continue ก็จะเห็นกล่องโต้ตอบการแชร์:

ผู้ใช้จะทราบว่าการแชร์สำเร็จ เมื่อเห็นข้อความยืนยัน

การใช้การเข้าสู่ระบบสำหรับอุปกรณ์

การเข้าสู่ระบบ Facebook สำหรับอุปกรณ์นั้นใช้กับอุปกรณ์ที่เรียก HTTP โดยตรงทางอินเทอร์เน็ต การเรียก API และการตอบสนองต่อไปนี้เป็นสิ่งที่อุปกรณ์สามารถทำได้

1. เปิดใช้การเข้าสู่ระบบสำหรับอุปกรณ์

โหลด แดชบอร์ดของแอพ และเปลี่ยนการตั้งค่า > ขั้นสูง > การตั้งค่า OAuth > เข้าสู่ระบบจากอุปกรณ์ ให้เป็น "ใช่"

2. สร้างโค้ด

เมื่อผู้ใช้คลิกการกระตุ้นให้ดำเนินการหรือ Share อุปกรณ์ควรทำ HTTP POST เป็น

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

คุณจะพบ CLIENT_TOKEN ในการตั้งค่าแอพ -> ขั้นสูงและควรรวมกับ ID ของแอพของคุณ (คั่นด้วยเครื่องหมาย Pipe |) เพื่อทำให้เกิด access_token ที่สมบูรณ์

นอกจากนี้ API ยังรองรับ action_type และ action_properties แทน href ในกรณีที่คุณต้องการที่จะแชร์ข้อมูล Open Graph อีกด้วย (ด้วยวิธีเดียวกันกับการดำเนินการ Open Graph ในกล่องการแชร์)

นอกจากนี้ API ยังรองรับพารามิเตอร์ quote และ hashtag (ด้วยวิธีเดียวกันกับพารามิเตอร์กล่องการแชร์)

การตอบสนองจะอยู่ในรูปแบบนี้

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

การตอบสนองนี้หมายถึง

  1. แสดงสตริง “A1NWZ9” บนอุปกรณ์ของคุณ
  2. แจ้งให้ผู้ใช้ไปที่ “facebook.com/device” และกรอกรหัสนี้
  3. โค้ดจะหมดอายุใน 420 วินาที คุณควรปิดการแสดงรหัสหลังจากนั้น

3. แสดงโค้ด

อุปกรณ์ควรแสดง user_code และแจ้งให้ผู้ใช้ไปที่ verification_uri เช่น facebook.com/device บนเดสก์ท็อปหรือสมาร์ทโฟน ดู ประสบการณ์ผู้ใช้

การแก้ไขปัญหา

ฉันจะสร้างคำขอโฟลว์บนอุปกรณ์ทาง HTTP ได้หรือไม่
API กราฟที่มีโทเค็นต้องใช้ TLS/HTTPS

ฉันจะสร้างคำขอโฟลว์บนอุปกรณ์ด้วยเมธอด GET ได้หรือไม่
คำขอโฟลว์บนอุปกรณ์ทั้งหมดควรเป็นคำขอ POST

ฉันจะทราบได้หรือไม่ว่าเมื่อใดที่ผู้ใช้แชร์เสร็จสิ้นแล้ว
หมายเลข

ฉันสามารถตั้งโปรแกรมให้โพสต์ในนามของบุคคลได้หรือไม่
ไม่ได้ หากต้องการทำเช่นนั้น คุณต้องขอให้ผู้ใช้เข้าสู่ระบบและขอสิทธิ์การอนุญาตเพื่อให้คุณทำการเผยแพร่ในนามพวกเขา สำหรับข้อมูลเพิ่มเติม โปรดดูที่ การเผยแพร่ด้วย API