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

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

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

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

يتناول هذا الدليل ما يلي:

• تجربة المستخدم
• تنفيذ المشاركة من الأجهزة
• استكشاف الأخطاء وإصلاحها

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

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

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

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

1. كتابة "مشاركة" أو "مشاركة على فيسبوك" على الزر.
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 في إعدادات التطبيق -> الإعدادات المتقدمة، ويجب دمجه مع معرف التطبيق (على أن يكون مفصولاً برمز الأنبوب |) من أجل صياغة 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.