Chia sẻ

Chia sẻ từ thiết bị

Điểm cuối này đã ngừng hoạt động từ ngày 02/11/2020.

Với tính năng Chia sẻ từ thiết bị, mọi người có thể dễ dàng chia sẻ nội dung từ các thiết bị lên Facebook. Các thiết bị này bao gồm TV thông minh, khung ảnh kỹ thuật số hoặc thiết bị trong mạng lưới Internet vạn vật.

Khi chia sẻ từ thiết bị, thiết bị của bạn sẽ hiển thị một mã gồm chữ và số, đồng thời yêu cầu mọi người nhập mã này vào trang web trên máy tính hoặc điện thoại thông minh của họ. Sau đó, những người sử dụng ứng dụng hoặc dịch vụ của bạn có thể chia sẻ nội dung lên Facebook bằng hộp thoại chia sẻ được liên kết với mã đó.

Nếu đang xây dựng ứng dụng dành cho thiết bị Apple TV hoặc Android, bạn nên lần lượt dùng SDK dành cho tvOS hoặc SDK dành cho Android.

Hướng dẫn này mô tả những nội dung sau:

Trải nghiệm người dùng

1. Nút kêu gọi hành động

Trước tiên, hãy cân nhắc xem bạn muốn yêu cầu mọi người chia sẻ nội dung lên Facebook ở đâu trong trải nghiệm người dùng. Để mang đến trải nghiệm tốt nhất, hãy thiết kế nút này càng giống nút Chia sẻ chính thức trên Facebook càng tốt. Nói chung, nút này nên nằm cạnh nội dung sẽ được chia sẻ.

Xét theo khía cạnh thiết kế trực quan, bạn nên

  1. Gắn nhãn nút là "Chia sẻ" hoặc "Chia sẻ lên Facebook".
  2. Sử dụng màu trắng và màu chính thức của thương hiệu Facebook là xanh da trời: #3B5998.
  3. Nếu thiết bị của bạn hỗ trợ hiển thị đồ họa, bạn cũng có thể kết hợp logo chữ "f" chính thức. Theo Nguyên tắc về thương hiệu của Facebook, logo luôn phải là màu trắng hoặc màu xanh da trời của Facebook (#3B5998).

2. Hiển thị mã

Khi ai đó nhấp vào nút kêu gọi hành động, thiết bị sẽ thực hiện lệnh gọi đến API của Facebook. API này sẽ trả về một mã.

Trong giao diện của bạn, hãy cho mọi người biết rằng họ cần truy cập vào trang web và nhập mã khi có thông báo sau: "Tiếp theo, hãy truy cập facebook.com/device (http://facebook.com/device) trên máy tính hoặc điện thoại thông minh và nhập mã này". Hiển thị toàn bộ mã bạn nhận được từ API Chia sẻ từ thiết bị của Facebook. Mã này dài từ 6 đến 12 ký tự.

Thêm nút Close hoặc Done để mọi người có thể hoàn tất quy trình Chia sẻ từ thiết bị.

3. Chia sẻ

Đây là quy trình mọi người sẽ nhìn thấy khi họ truy cập facebook.com/device trên trình duyệt máy tính hoặc di động. Đầu tiên, họ sẽ nhìn thấy một trường văn bản để nhập mã:

Sau khi nhập mã và nhấp vào Continue, họ sẽ nhìn thấy Hộp thoại chia sẻ:

Một thông báo xác nhận sẽ hiển thị để mọi người biết quá trình chia sẻ của mình thành công:

Triển khai tính năng Chia sẻ từ thiết bị

Tính năng Chia sẻ từ thiết bị trên Facebook dành cho những thiết bị có thể thực hiện lệnh gọi HTTP qua Internet. Sau đây là các lệnh gọi và phản hồi API mà thiết bị của bạn có thể thực hiện.

1. Bật tính năng Đăng nhập từ thiết bị

Tải bảng điều khiển của ứng dụng và thay đổi phần Cài đặt > Nâng cao > Cài đặt OAuth > Đăng nhập từ thiết bị thành "Có".

2. Tạo mã

Khi một người nhấp vào nút kêu gọi hành động Share, thiết bị của bạn sẽ gửi yêu cầu HTTP POST đến:

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

CLIENT_TOKEN có trong phần Cài đặt ứng dụng -> Nâng cao và phải được kết hợp với ID ứng dụng của bạn (được phân cách bằng dấu sổ thẳng - |) để tạo thành access_token hoàn chỉnh.

Ngoài ra, API này còn hỗ trợ action_type và action_properties thay vì href nếu bạn muốn chia sẻ tin đăng bằng Open Graph (theo cách tương tự như hành động trong Open Graph thông qua Hộp thoại chia sẻ).

API này cũng hỗ trợ các thông số quote và hashtag (theo cách tương tự như thông số Hộp thoại chia sẻ).

Phản hồi có dạng sau:

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

Phản hồi này nghĩa là:

  1. Hiển thị chuỗi "A1NWZ9" trên thiết bị của bạn.
  2. Yêu cầu người đó truy cập "facebook.com/device" và nhập mã này.
  3. Mã sẽ hết hạn sau 420 giây. Sau thời gian đó, bạn nên đóng cửa sổ hiển thị mã này.

3. Hiển thị mã

Thiết bị của bạn sẽ hiển thị user_code và yêu cầu mọi người truy cập verification_uri, chẳng hạn như facebook.com/device trên máy tính hoặc điện thoại thông minh của họ. Hãy xem phần Trải nghiệm người dùng.

Khắc phục sự cố

Tôi có thể gửi yêu cầu quy trình thiết bị qua HTTP không?
Đối với API Đồ thị có mã truy cập, bạn phải gửi yêu cầu qua TLS/HTTPS.

Tôi có thể gửi yêu cầu quy trình thiết bị bằng phương thức GET không?
Tất cả yêu cầu quy trình thiết bị đều phải là yêu cầu POST.

Tôi có thể biết thời điểm người dùng hoàn tất quá trình chia sẻ không?
Không.

Tôi có thể đăng theo cách lập trình thay mặt một người không?
Không. Để làm việc đó, bạn phải yêu cầu người dùng đăng nhập và cấp quyền để bạn đăng thay mặt họ. Hãy xem phần đăng bằng API Đồ thị để tìm hiểu thêm.