Взаимодействие со зрителями

С помощью API Live Video можно получать комментарии и реакции на прямые видеотрансляции. Это позволяет организаторам и участникам эфира взаимодействовать со зрителями. Для этого можно периодически обращаться к объекту LiveVideo, чтобы получать текущие комментарии и реакции, или настроить SSE (события, посылаемые сервером), чтобы получать комментарии и реакции в режиме реального времени.

Получение текущих комментариев и реакций

Чтобы получить текущие комментарии или реакции на прямую видеотрансляцию, отправьте запрос к таким конечным точкам:

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

Информацию о возвращаемых полях, а также инструкции по фильтрации и упорядочению см. в справке по границам контекста Comments и Reactions. Комментарии и реакции можно запрашивать с интервалом в несколько секунд.

Получение комментариев и реакций в режиме реального времени

Для получения комментариев и реакций в браузерных клиентах в режиме реального времени настройте SSE и отправьте запрос к этим конечным точкам:

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

Информацию о возвращаемых полях, частоте вызова и фильтрации см. в справке по комментариям к прямому эфиру и реакциям на прямой эфир.