Support for Live Video API for Facebook

يؤدي بث البرامج أو برامج ترميز RTMP إلى الحصول على مفتاح وعنوان URL لبث RTMP وإرسالهما إلى فيسبوك. ولا نوفر برنامج البث. ويمكن للعديد من عمليات البث المباشر استخدام برنامج OBS (Open Broadcasting Software) أو Player.me أو البرنامج الذي يوفر إصدارات مجانية.

نعم! يرجى الرجوع إلى قائمة شركاء حلول الوسائط المتوفرة لدينا.

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

توجد فترة تأخر تتراوح بين 4 و5 ثوان عند البث المباشر وإلى أن يظهر الفيديو الخاص بك على فيسبوك. وستعرف أن الوقت انتهى عندما ترى تشغيل الفيديو في الصفحة الاختبارية (أو العامة) لديك.

If you are having issues with your live streams, please refer to our guides to make sure that you are using our API correctly. We also recommend reviewing our video specifications to ensure that your settings are best suited for a quality live stream. If you believe you have run into a bug, you can send it directly to our Bug Tool and an engineer will get back to you.

Yes you can! The second stream will likely get fewer inferred notifications than the first. Please refer to our Best Practices documentation for more information on how notifications work.

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

Our default aspect ratio is 16x9, though we infer the aspect ratio from the stream. For complete specifications, see our reference.

يمكنك تضمين مقاطع فيديو البث المباشر باستخدام المعلمة embeddable من خلال واجهة API فيديو البث المباشر.

أرسل طلب POST /{live_video_id}، وقم بتعيين المعلمة embeddable إلى الحالة true. استخدم رمز وصول الصفحة أو المستخدم بالأذونات نفسها المطلوبة عند إنشاء فيديو بث مباشر.

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

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-live-video-id}",
  new JSONObject("{}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live-video-id}"
           parameters:@{ @"embeddable": @"true",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-live-video-id}',
  'POST',
  {"embeddable":"true"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-live-video-id}',
    array (
      'embeddable' => 'true'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

للحصول على HTML مضمّن، أرسل طلب GET /{live_video_id}?fields=embed_html. استخدم رمز وصول الصفحة أو المستخدم بالأذونات نفسها المطلوبة عند إنشاء فيديو بث مباشر.

curl -i -X GET \
 "https://graph.facebook.com/{your-live_video_id}
   ?fields=embed_html
   &access_token={your-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-live_video_id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "embed_html");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live_video_id}"
           parameters:@{ @"fields": @"embed_html",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-live_video_id}',
  'GET',
  {"fields":"embed_html"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-live_video_id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

عينة من الاستجابة

{ "embed_html": "<iframe src=\"https://www.facebook.com/plugins/video.php?href=https%3A%2F%2Fwww.facebook.com%2Fyourpage%2Fvideos%2F{your-page-id}%2F&width=0\" width=\"0\" height=\"0\" style=\"border:none;overflow:hidden\" scrolling=\"no\" frameborder=\"0\" allowTransparency=\"true\" allowFullScreen=\"true\"></iframe>", "id": "{your-live-video-id}" } 

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

فيما يلي بعض الأسباب المتعلقة باحتمالية حدوث ذلك. وفيما يلي بعض الأسباب الأكثر شيوعًا:

1. في حالة تشغيل موسيقى في خلفية فيديو البث المباشر الخاص بك، سيتم التخلص من الفيديو الخاص بك بسبب انتهاك حقوق النشر. وقد يحدث ذلك أثناء بث فيديو البث المباشر أو بعد ذلك عند إعادة تشغيل فيديو حسب الطلب (VOD).
2. قد قمت أنت أو أي مؤلف آخر في صفحتك بحذف فيديو البث المباشر. في حالة حذف فيديو بث مباشر يدويًا، لا يمكن استرداده.
3. قد تم تمييز الفيديو الخاص بك تلقائيًا بسبب انتهاك بروتوكول IP. وفي حالة حدوث ذلك، سيرسل فيسبوك إليك بريدًا إلكترونيًا يحتوي على رابط تستخدمه لمراجعة عملية التخلص هذه وإعادة تقديم الفيديو من أجل مراجعته من خلال فريق السياسة لدينا.

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

Check our list of error codes to best understand your issue.

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

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

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

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

Yes, you can geo-gate (restrict who can see your video depending on the viewer's location). See Audience Targeting to learn how.

Yes, you can! See Audience Targeting to learn how.

Yes, videos taken down for copyright violation can be restored. You should receive a notification that gives you the option to restore the video. However, if you do not take this action when you receive the notification, the video can no longer be restored.

لا، للأسف، لا يمكن ترويج مقاطع فيديو البث المباشر حاليًا.

لا تتوفر حاليًا نقطة نهاية من أجل إنشاء شروحات توضيحية مُغلقة. ومع ذلك، يمكنك إضافة شروحات توضيحية مُغلقة إلى عمليات بث LiveVideo بعد إنهائها أو يمكنك إضافة شروحات توضيحية مُغلقة إلى عملية بث فيديو البث المباشر نظرًا لأنها تقوم بالبث إلى الخوادم الخاصة بنا باستخدام المعيار CEA-608 للشروحات التوضيحية المُغلقة.

لإضافة شروحات توضيحية إلى LiveVideo الذي تم إنهاؤه (أي أنها تتضمن حالة فيديو حسب الطلب (VOD))، يمكنك الرجوع إلى موضوع المساعدة "كيف يمكنني إضافة شروحات توضيحية إلى الفيديو الموجود في صفحتي؟". ولإضافة شروحات توضيحية باستخدام المعيار CEA-608، يمكنك الرجوع إلى دليل الشروحات التوضيحية المتوفرة لدينا.

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

We encourage all live broadcasts to exclusively contain live content so as to preserve the integrity of the viewer's experience. However, there are unique cases in which cutting to a pre-recorded clip makes sense, similar to how a news show might show previously recorded content on live TV.

Yes, refer to our Crossposting guide and How do I crosspost another Page's video? Help Center topic to learn how. Comments and reactions are shown only in the original Page.

للظهور على خريطة البث المباشر، يجب عليك تعيين موقع الفيديو الخاص بك من خلال استخدام المعلمة place في طلب POST /{live_video_id}.

لإعادة تعيين مفتاح دائم، انتقل إلى www.facebook.com/live/create وانقر على إنشاء بث مباشر وحدد مربع الاختيار استخدام مفتاح بث دائم، ثم انقر على الزر إعادة التعيين.