Interactuar con los espectadores

Puedes utilizar la API de vídeo en directo para obtener comentarios y reacciones sobre transmisiones de vídeo en directo, de modo que los presentadores y productores del vídeo puedan interactuar con los espectadores. Puedes hacerlo de forma periódica consultando el objeto LiveVideo para obtener comentarios y reacciones actuales, o bien configurar eventos enviados por el servidor para recibir comentarios y reacciones en tiempo real.

Obtener comentarios y reacciones actuales

Para obtener comentarios y reacciones actuales sobre una transmisión de vídeo en directo, envía una solicitud a:

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

Solicitud de ejemplo

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();

Ejemplo de respuesta

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

Consulta las referencias del perímetro Comentarios y Reacciones para obtener información sobre los campos que se pueden devolver, así como instrucciones para filtrar y ordenar. Los comentarios y las reacciones se pueden consultar cada pocos segundos.

Obtener comentarios y reacciones en tiempo real

Para recibir comentarios y reacciones en clientes de navegador en tiempo real, configura eventos enviados por el servidor y envía una solicitud a estos extremos:

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

Ten presente que la URL del host para la transmisión de eventos es https://streaming-graph.facebook.com.

Solicitud de ejemplo

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
};

Ejemplo de respuesta

: 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

Consulta las referencias Comentarios en directo y Reacciones en directo para obtener información sobre los campos que se pueden devolver, la frecuencia del ping y la filtración.