المشاركة للأجهزة

من خلال ميزة مشاركة الأجهزة، يستطيع الأشخاص مشاركة المحتوى من الأجهزة إلى فيسبوك. يتضمن هذا أجهزة التلفزيون الذكية أو أطر الصور الرقمية أو أجهزة إنترنت الأشياء.

مع مشاركة الأجهزة، يعرض جهازك رمزًا أبجديًا رقميًا ويطلب من الأشخاص إدخاله بصفحة ويب على أجهزة الكمبيوتر أو الهواتف الذكية. يستطيع الأشخاص الذين يستخدمون تطبيقك أو خدمتك مشاركة المحتوى إلى فيسبوك من خلال مربع حوار مشاركة مرتبط بالرمز البرمجي.

إذا كنت تقوم بإنشاء تطبيق ليتوافق مع أجهزة Apple TV أو Android، يجب استخدام SDK لـ tvOS أو SDK لـ Android على الترتيب.

يتناول هذا الدليل الموضوعات التالية:

تجربة المستخدم

1. الدعوة لاتخاذ إجراء

فكر أولاً في النقطة التي تريد عندها ضمن تجربة المستخدم مطالبة الأشخاص بمشاركة المحتوى على فيسبوك. لضمان توفير أفضل تجربة، قم بتصميم الزر ليتشابه لأكبر درجة مع زر مشاركة فيسبوك الرسمي. بوجه عام، يجب أن يكون الزر بجوار المحتوى المطلوب مشاركته.

من وجهة نظر التصميم المرئي، يعني ذلك أنه عليك

  1. تسمية الزر "Share" (مشاركة) أو “Share to Facebook” (مشاركة على فيسبوك).
  2. استخدام اللون الأبيض مع لون علامة فيسبوك التجارية الأزرق الرسمي: #3B5998.
  3. إذا كان جهازك يدعم العرض الرسومي، يمكنك أيضًا تضمين شعار "f" الرسمي. بموجب إرشادات علامة فيسبوك التجارية، يجب أن يكون الشعار إما باللون الأبيض أو اللون الأزرق لفيسبوك (#3B5998).

2. عرض الرمز

عندما ينقر الشخص على زر الدعوة لاتخاذ إجراء، يُجري جهازك عملية استدعاء لواجهة API فيسبوك التي تعرض الرمز البرمجي.

في واجهتك، أخبر الأشخاص أنهم يحتاجون لزيارة موقع على الويب وإدخال الرمز مع الرسالة التالية، "بعد ذلك، تفضل بزيارة facebook.com/device (http://facebook.com/device) من جهاز الكمبيوتر أو الهاتف الذكي وأدخل هذا الرمز". اعرض الرمز الكامل الذي تلقيته من واجهة API مشاركة على فيسبوك للأجهزة. يتراوح طول الرمز بين 6 إلى 12 حرفًا.

قم بتضمين زر Close أو Done بحيث يمكن للأشخاص إتمام دفق مشاركة الأجهزة.

3. المشاركة

هذا هو الدفق الذي يراه الأشخاص عند انتقالهم إلى facebook.com/device من متصفح جهاز الكمبيوتر أو الهاتف المحمول. في البداية، سيرون حقلاً نصيًا يمكنهم إدخال الرمز به:

بعد إدخال الرمز الخاص بهم والنقر على Continue، يتم عرض مربع حوار المشاركة لهم:

ولكي يعلم الأشخاص أن عملية المشاركة ناجحة، سيرون رسالة تأكيد:

تنفيذ المشاركة للأجهزة

مشاركة فيسبوك للأجهزة مخصص للأجهزة التي يمكنها إجراء استدعاءات 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 من App Settings (إعدادات التطبيق) -> Advanced (متقدم)، ويجب دمجها مع معرف التطبيق مع الفصل بينهما بعلامة |) من أجل صياغة 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؟
Graph API مع الرموز تتطلب TLS/HTTPS.

هل يمكنني إجراء طلبات دفق أجهزة باستخدام طريقة GET؟
يجب أن تكون كل طلبات دفق الأجهزة طلبات POST.

هل يمكنني معرفة وقت إتمام الشخص للمشاركة؟
لا.

هل يمكنني النشر بالنيابة عن الشخص بطريقة برمجية؟
لا. للقيام بذلك، يجب أن تطلب من المستخدم تسجيل الدخول ومنحك الأذونات للنشر بالنيابة عنه. راجع النشر باستخدام Graph API لمعرفة المزيد.