그래프 API 버전

그룹 라이브 방송

라이브 방송 API에 대한 자세한 내용은 라이브 방송 문서를 참조하세요.

만들기

다음 경로에서 live_videos 에지로 POST 요청을 보낼 수 있습니다.

/{group-id}/live_videos

이 에지에 게시할 때 LiveVideo가 생성됩니다.

매개변수

이름	설명
`app_attribution_tag` 숫자 문자열 또는 정수	피드에 표시되는 라이브 방송의 기여 태그입니다.
`attribution_app_id` 숫자 문자열 또는 정수	기여 앱의 ID입니다.
`content_tags` list<숫자 문자열>	동영상의 내용을 설명하는 태그입니다. `type=adinterest`인 검색 엔드포인트를 사용하여 가능한 ID를 가져옵니다. 쿼리 예시: /search?type=adinterest&q=sunsets
`description` UTF-8 문자열	라이브 방송에 대한 설명입니다. 이모지를 지원합니다.
`encoding_settings` 문자열	방송 진행자가 이 스트리밍 동영상에 사용 중인 인코딩 설정 그룹의 식별자입니다. 이 매개변수는 현재 라이브 360 방송에서만 사용하고 있습니다. 이 매개변수에 전달되는 값은 인코딩 기본 설정의 `identifier` 키 값입니다. 인코딩 기본 설정은 `/broadcaster_encoding_settings` 그래프 API 엔드포인트를 쿼리(`GET` 쿼리)하여 확인할 수 있습니다.
`event_params` 정수	방송이 시작될 시점에 대한 UNIX 타임스탬프입니다.
`fisheye_video_cropped` 부울	단일 어안렌즈 동영상을 자를지 여부를 나타냅니다.
`front_z_rotation` 부동 소수점	단일 어안렌즈 동영상에서 앞쪽 z 회전 각도입니다.
`game_id` 숫자 문자열 또는 정수	이 동영상이 주제로 하는 게임을 설정합니다. `type=game`인 검색 엔드포인트를 사용하여 가능한 ID를 가져옵니다. 쿼리 예시: /search?type=game&=pubg
`game_specs` 게임 사양 매개변수	출처가 되는 게임을 나타내는 메타데이터를 설정합니다.
`is_spherical` 부울	방송이 360도 라이브 방송임을 나타내는 플래그입니다.
`live_encoders` list<숫자 문자열 또는 정수>	이 라이브 방송에 방송될 라이브 인코더입니다.
`original_fov` int64	카메라의 원래 시야각입니다.
`post_surfaces_blacklist` list<enum{1, 2, 3, 4, 5}>	피드 전용 경험과 관련하여 게시물을 표시하지 않을 장소의 블랙리스트입니다.
`privacy` 공개 범위 매개변수	이 라이브 동영상의 공개 범위입니다.
`projection` enum{EQUIRECTANGULAR, CUBEMAP}	360도 라이브 스트리밍 동영상의 예상 투사를 나타내는 플래그입니다. 기본값은 EQUIRECTANGULAR입니다.
`save_vod` 부울	나중에 VOD 형식으로 사용하기 위해 동영상 데이터를 저장할지 여부를 나타냅니다. 기본값은 true입니다. (참고: 생성 시점에서만 설정할 수 있음)
`schedule_custom_profile_image` 이미지	예정된 라이브 스토리 및 로비에 표시될 맞춤 이미지입니다.
`spatial_audio_format` enum{ambiX_4}	입체 사운드 스트리밍 동영상의 형식을 나타냅니다. 명시되지 않은 오디오를 모노 또는 스테레오로 추정할 때 사용합니다.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	방송의 상태입니다. `LIVE_NOW` 방송은 현재 생방송 중이고 사용자에게 표시되고 있습니다. `UNPUBLISHED` 방송은 준비 단계이고 다른 사용자에게 보이지 않습니다. 비공개 상태인 방송은 이 상태에서 몇 시간이 지나면 자동으로 삭제될 수 있습니다. 미래에 계획된 방송을 생성하려면 예약됨 상태를 사용하는 것이 좋습니다.
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	이 동영상에 대해 이 플래그를 입체 모드로 설정합니다.
`stop_on_delete_stream`	`true`로 설정하면 `deleteStream` RTMP 명령을 수신했을 때 스트리밍 동영상이 중단됩니다.
`title` UTF-8 문자열	라이브 방송의 제목입니다. 이모지를 지원합니다.

반환 유형

이 엔드포인트는 쓰기 후 읽기를 지원하고 반환 유형에서 id로 표시되는 노드를 읽습니다.

Struct { id: numeric string, stream_url: string, secure_stream_url: string, stream_secondary_urls: List [ string ], secure_stream_secondary_urls: List [ string ], dash_ingest_url: string, }

검증 규칙

오류	설명
100	잘못된 매개변수
200	권한 오류

읽기

기능

이름	설명
그룹 API	앱 검수가 필요한 기능입니다.

예시

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/live_videos",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

GET /v7.0/{group-id}/live_videos HTTP/1.1
Host: graph.facebook.com

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/live_videos"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

/* make the API call */
FB.api(
    "/{group-id}/live_videos",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}/live_videos',
    'your-access-token'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

그래프 API에 대한 자세한 내용은 그래프 API 사용 가이드를 참조하세요.

매개변수

이름 설명

이름	설명
`broadcast_status` list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	반환할 종류의 라이브 방송을 지정할 수 있습니다. 모든 상태 유형을 반환하는 값은 없습니다.
`source` enum{target, owner}	기본값: `target` 동영상을 쿼리해야 하는 위치의 출처입니다. 예: `target`은 그룹에 동영상을 방송합니다. 그룹 라이브 동영상만 `target`을 지원합니다.

broadcast_status

list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>

반환할 종류의 라이브 방송을 지정할 수 있습니다. 모든 상태 유형을 반환하는 값은 없습니다.

source

enum{target, owner}

기본값: target

동영상을 쿼리해야 하는 위치의 출처입니다. 예: target은 그룹에 동영상을 방송합니다. 그룹 라이브 동영상만 target을 지원합니다.

필드

이 에지에서 읽으면 다음과 같이 JSON 형식의 결과가 반환됩니다.

{ "data": [], "paging": {} }

data

LiveVideo 필드의 리스트입니다.

paging

페이지 매김에 대한 자세한 내용은 그래프 API 가이드를 참조하세요.

검증 규칙

오류	설명
200	권한 오류

업데이트

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.

삭제

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.