閲覧者とのやり取り

ライブ動画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

値が返されるフィールド、pingの頻度、フィルタリングについては、ライブコメントおよびライブリアクションのリファレンスをご覧ください。