البدء

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

قبل البدء

إذا كان لديك تطبيق، فستحتاج إلى ما يلي:

• معرف تطبيق Meta مع حالة استخدام تسجيل دخول فيسبوك
• تنفيذ تسجيل دخول فيسبوك في تطبيقك

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

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

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

بدء البث

لإنشاء كائن LiveVideo، أرسل طلب POST إلى نقطة النهاية /me/live_videos?status=LIVE_NOW حيث يكون me هو معرف المستخدم أو الصفحة.

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

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

{ 
  "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.

نشر البث

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

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

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

إنهاء البث

لإنهاء البث، أرسل طلب POST إلى نقطة النهاية /<LIVE_VIDEO_ID>?end_live_video=true.

مثال على طلب إنهاء البث

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

سيؤدي ذلك إلى إنهاء البث الخاص بك وحفظه كفيديو حسب الطلب (VOD). وإذا كنت تريد حذف فيديو حسب الطلب (VOD)، فأرسل طلبًا إلى نقطة النهاية DELETE /<LIVE_VIDEO_ID>.

رموز أخطاء رفض الإذن

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

• استخدم API فيديو البث المباشر لجدولة فيديو بث مباشر وبثه في المستقبل.