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

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

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

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

คู่มือนี้จะอธิบายสิ่งต่างๆ ดังต่อไปนี้

• ประสบการณ์ผู้ใช้
• ใช้งานการแชร์สำหรับอุปกรณ์
• การแก้ไขปัญหา

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

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

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

จากมุมมองของการออกแบบภาพ หมายความว่าคุณควรที่จะ

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

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 ของแอพคุณ (คั่นด้วยเครื่องหมายขีดตั้ง |) เพื่อสร้าง 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 บน PC หรือสมาร์ทโฟนของตน ดูประสบการณ์ผู้ใช้

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

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

ฉันสามารถสร้างคำขอขั้นตอนของอุปกรณ์ด้วยวิธีการ GET ได้หรือไม่
คำขอขั้นตอนของอุปกรณ์ทั้งหมดควรเป็นคำขอ POST

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

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