วิดีโอถ่ายทอดสดของกลุ่ม
    เวอร์ชันของ API กราฟ

    วิดีโอถ่ายทอดสดของกลุ่ม

    โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับ API วิดีโอถ่ายทอดสดที่เอกสารเกี่ยวกับวิดีโอถ่ายทอดสดของเรา

    การสร้าง

    คุณสามารถสร้างคำขอ POST ไปยังจุดเชื่อมโยง live_videos จากพาธต่อไปนี้

    • /{group-id}/live_videos

    ระบบจะสร้างวิดีโอถ่ายทอดสดขึ้นเมื่อโพสต์ไปยังจุดเชื่อมโยงนี้

    พารามิเตอร์

    ชื่อคำอธิบาย
    app_attribution_tag

    สตริงตัวเลขหรือจำนวนเต็ม

    แท็กการระบุที่มาสำหรับวิดีโอถ่ายทอดสดที่จะแสดงบนฟีด

    attribution_app_id

    สตริงตัวเลขหรือจำนวนเต็ม

    ID ของแอพการระบุที่มา

    content_tags

    list<numberic string>

    แท็กที่อธิบายเนื้อหาของวิดีโอ ใช้ตำแหน่งข้อมูลการค้นหากับ type=adinterest เพื่อรับ ID ที่เป็นไปได้ การสืบค้นตัวอย่าง:

    /search?type=adinterest&q=sunsets

    description

    สตริง UTF-8

    คำอธิบายของวิดีโอถ่ายทอดสด อีโมจิสนับสนุน

    encoding_settings

    สตริง

    ตัวระบุของกลุ่มการตั้งค่าการเข้ารหัสที่ผู้แพร่ภาพกำลังใช้สำหรับสตรีมนี้ ขณะนี้ พารามิเตอร์นี้มีการใช้งานในการแพร่ภาพสดแบบ 360 องศาเท่านั้น ค่าที่จะส่งไปยังพารามิเตอร์นี้เป็นค่าของคีย์ identifier ของค่าที่กำหนดไว้ล่วงหน้าของการตั้งค่าการเข้ารหัส ค่าที่กำหนดไว้ล่วงหน้าของการเข้ารหัสสามารถค้นหาได้ด้วยการสืบค้นตำแหน่งข้อมูล API กราฟ /broadcaster_encoding_settings (การสืบค้น 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<numberic string or integer>

    ตัวเข้ารหัสแบบสดที่จะแพร่ภาพไปยังวิดีโอถ่ายทอดสดนี้

    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}

    ตั้งค่าสถานะนี้เป็นโหมดระบบภาพ 3 มิติสำหรับวิดีโอนี้

    stop_on_delete_stream

    ตั้งค่ารายการนี้เป็น true หากระบบควรหยุดสตรีมเมื่อได้รับคำสั่ง RTMP deleteStream

    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 เท่านั้น

    ช่อง

    การอ่านจากจุดเชื่อมโยงนี้จะส่งคืนผลลัพธ์ที่มีการจัดรูปแบบ JSON

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

    รายการช่องของวิดีโอถ่ายทอดสด

    paging

    หากต้องการรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้า โปรดดูคู่มือ API กราฟ

    กฎการตรวจสอบความถูกต้อง

    ข้อผิดพลาดคำอธิบาย

    200

    ข้อผิดพลาดของสิทธิ์การอนุญาต

    การอัพเดต

    คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

    การลบ

    คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้