التفاعل مع المشاهدين

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

الحصول على التعليقات والتفاعلات الحالية

للحصول على التعليقات أو التفاعلات الحالية بشأن عملية بث فيديو البث المباشر، أرسل طلبًا إلى:

GET /{live-video-id}/comments
GET /{live-video-id}/reactions

عينة من الطلب

curl -i -X GET \
  "https://graph.facebook.com/{live-video-id}/comments?access_token={access-token}"

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

request.executeAsync();

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

FB.api(
  '/{live-video-id}/comments',
  'GET',
  {},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{live-video-id}/comments',
    '{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();

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

{
  "data": [
    {
      "created_time": "2018-08-30T18:47:02+0000",
      "from": {
        "name": "Steph C.",
        "id": "552524095105158"
      },
      "message": "This is such a great live stream.",
      "id": "911936075671494_911936769004758"
    },
    {
      "created_time": "2018-08-30T18:47:17+0000",
      "from": {
        "name": "Kevin D.",
        "id": "552524095105158"
      },
      "message": "Shoutout over here!",
      "id": "911936075671494_911936909004744"
    },
    {
      "created_time": "2018-08-30T18:48:14+0000",
      "from": {
        "name": "Clay T.",
        "id": "552524095105158"
      },
      "message": "Where is this place?",
      "id": "911936075671494_911937292338039"
    }
    ],
  "paging": {
    "cursors": {
      "before": "WTI5d...",
      "after": "WTI5d..."
    }
  }
}

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

تلقي تعليقات وتفاعلات فورية

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

GET /{live-video-id}/live_comments
GET /{live-video-id}/live_reactions

لاحظ أن عنوان URL للمضيف في أحداث البث هو: https://streaming-graph.facebook.com

عينة من الطلب

GET https://streaming-graph.facebook.com/{live-video-id}/live_comments?access_token={access-token}

var source = new EventSource("https://streaming-graph.facebook.com/{live-video-id}/live_comments?access_token={access-token}");
source.onmessage = function(event) {
  // Do something with event.message for example
};

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

: ping
data:
  {
    "created_time":"2018-08-30T21:11:01+0000",
    "id":"911936075671494_912014908996944",
    "view_id":43329028,
    "from":
      {
        "id":"552524095105158",
        "name":"Kerry Fisher"
      },
    "message":"I love this video!"
  }
: ping
: ping

للحصول على معلومات حول الحقول القابلة للإرجاع وتكرار اختبارات الاتصال والفلترة، يمكنك الرجوع إلى مراجع تعليقات البث المباشر وتفاعلات البث المباشر.