بدء الاستخدام

يوضح لك هذا المستند طريقة استخدام API فيديو البث المباشر لإنشاء بث فيديو مباشر في الملف الشخصي للمستخدم لديك باستخدام تطبيقك. وإذا لم يتوفر لديك أي تطبيق، فيمكنك استخدام مستكشف Graph API وبرنامج البث المجاني، مثل OBS أو Player.me.

قبل البدء

ستحتاج إلى الوصول إلى ما يلي:

• حساب مطوّر في فيسبوك
• تطبيق فيسبوك مسجّل مع تكوين الإعدادات الأساسية

أما إذا لم يتوفر لديك أي تطبيق، فستحتاج أيضًا إلى ما يلي:

• برنامج بث الفيديو
• دراية بأساسيات مستكشف Graph API

1. تكوين تسجيل دخول فيسبوك

أضف منتج تسجيل دخول فيسبوك إلى تطبيقك في لوحة معلومات التطبيق.

يمكنك الاحتفاظ بتعيين كل الإعدادات إلى الوضع الافتراضي. إذا كنت تقوم بتنفيذ تسجيل دخول فيسبوك يدويًا (الأمر الذي لا نوصيك به)، فأدخل redirect_uri في حقل محددات URI لإعادة التوجيه لدى تصريح OAuth الصالح. وإذا كنت ستستخدم إحدى مجموعات SDK المتوفرة لدينا، يمكنك ترك الحقل فارغًا.

2. تنفيذ تسجيل دخول فيسبوك

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

سيحتاج تطبيقك إلى الأذونات التالية:

• publish_video

إذا لم يكن تطبيقك جاهزًا وكنت تستخدم مستكشف Graph API وبرامج البث، فيمكنك تخطي هذه الخطوة.

3. الحصول على رمز وصول

بمجرد تنفيذ تسجيل دخول فيسبوك، تأكد من أنك سجّلت الدخول إلى حساب مطوّر في فيسبوك، ثم قم بالوصول إلى تطبيقك وتشغيل تسجيل دخول فيسبوك المشروط. وإذا كنت تستخدم مستكشف Graph API، فحدد تطبيقك من القائمة المنسدلة تطبيق فيسبوك وانقر على الزر إنشاء رمز وصول.

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

وإذا كنت تستخدم مستكشف واجهة Graph API، فسيتم الحصول عليه تلقائيًا وعرضه في الحقل رمز الوصول من أجل الرجوع إليه:

4. إنشاء كائن LiveVideo

يتوفر لديك الآن رمز وصول مع الإذن publish_video، لذا يمكنك استخدامه لإنشاء كائن LiveVideo في الملف الشخصي للمستخدم لديك.

أرسل طلبًا إلى نقطة النهاية POST /me/live_videos?status=LIVE_NOW. على سبيل المثال:

curl -i -X POST \
 "https://graph.facebook.com/v3.3/me/live_videos?status=LIVE_NOW&access_token={access-token}"

سيؤدي ذلك إلى إرجاع استجابة تبدو كما يلي:

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

احصل على القيمتين id وsecure_stream_url اللتين تم إرجاعهما إليك. وتشير القيمة id إلى معرف كائن LiveVideo الذي يمكنك استخدامه لمعالجة البث. في حين تشير القيمة secure_stream_url إلى عنوان URL للاستيعاب الذي ستستخدمه من أجل بث بيانات فيديو البث المباشر من برنامج الترميز إلى الكائن LiveVideo.

5. البث إلى عنوان URL للبث الآمن

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

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

إذا كنت تستخدم برامج البث بدلاً من تطوير تطبيقك، فأضف القيمة secure_stream_url يدويًا إلى البرنامج الخاص بك. وبناءً على برنامج البث الذي تستخدمه، قد تتمكّن من تقسيم عنوان URL للبث إلى الخادم الخاص به (rtmps://rtmp-api.facebook.com/rtmp/) ومكونات المفتاح (كل الكلمات التي تأتي بعد /rtmp/).

فعلى سبيل المثال، في OBS، اختر OBS > التفضيلات. وسيؤدي ذلك إلى فتح الشاشة الإعدادات. قم بتعيين الخدمة إلى Facebook Live وأضف عنوان URL للبث في الإعدادات > البث > مفتاح البث، ثم ابدأ عملية البث الخاصة بك.

6. إنهاء البث

بمجرد التحقق من أنك تقوم ببث فيديو البث المباشر في الملف الشخصي، يمكنك إنهاء البث من خلال إرسال طلب إلى نقطة النهاية POST /{live-video-id}?end_live_video=true. على سبيل المثال:

curl -i -X POST \
  "https://graph.facebook.com/v3.3/{live-video-id}?end_live_video=true&access_token={access-token}"

سيؤدي ذلك إلى إنهاء البث الخاص بك وحفظه كفيديو حسب الطلب (VOD). وإذا كنت تريد حذف فيديو حسب الطلب (VOD)، فأرسل طلبًا إلى نقطة النهاية DELETE /{live-video-id}.

الخطوات التالية

اعثر على المزيد من الأمثلة حول استخدام API فيديو البث المباشر بغرض جدولة فيديو البث المباشر والنشر في صفحة أو مجموعة والحصول على تعليقات وتفاعلات المستخدم في الاستخدامات الشائعة.