Version API du graphe

User Live Videos

Represents a collection of LiveVideos on a User.

À partir du 10 juin 2024, les comptes Facebook devront remplir de nouvelles conditions de Meta avant d’être considérés comme actifs. Les nouvelles conditions requises sont les suivantes :

Le compte Facebook doit avoir été créé il y a au moins 60 jours
La page Facebook ou le profil en mode professionnel doit compter au moins 100 followers

Lecture

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Création

You can make a POST request to live_videos edge from the following paths:

/{user_id}/live_videos

When posting to this edge, a LiveVideo will be created.

Paramètres

Paramètre	Description
`content_tags` list<numeric string>	Tags that describe the contents of the video. Use search endpoint with `type=adinterest` to get possible IDs. `Example: ~~~~ /search?type=adinterest&q=couscous ~~~~`
`description` string	The description of the live video.
`donate_button_charity_id` numeric string or integer	Specifies the ID of the charity for which a donate button will be added to the live video.
`enable_backup_ingest` boolean	Set this to true to enable a backup ingest url. stop_on_delete_stream defaults to false when set
`encoding_settings` string	Identifier of the encoding settings group the broadcaster is using for this stream. This parameter is currently only in use for live-360 broadcasts. The value to be passed to this parameter is the value of the `identifier` key of the encoding settings preset. Encoding presets can be found by querying the `/broadcaster_encoding_settings` Graph API endpoint (`GET` query).
`event_params` Live Video Event Parameter	Parameters specific to Live Online Event broadcast. If `start_time` (unix timecode) is set, LOE's start time will be updated. Also, `cover` (url) uploads an image to use as the cover photo for the event. Example: { start_time: 1641013200, cover: 'https://your.url/image.jpg', }
`fisheye_video_cropped` boolean	Whether the single fisheye video is cropped or not
`front_z_rotation` float	The front z rotation in degrees on the single fisheye video
`is_spherical` boolean	Flag that denotes the broadcast is a 360 live broadcast.
`original_fov` int64	Original field of view of the camera
`privacy` Privacy Parameter	Privacy for this live video.
`projection` enum {EQUIRECTANGULAR, CUBEMAP, HALF_EQUIRECTANGULAR}	Flag that denotes expected projection for 360 live streams. The default value is EQUIRECTANGULAR.
`published` boolean	Set this to false to preview the stream before going live. `Deprecated. Prefer setting the status instead.`
`schedule_custom_profile_image` image	Custom image that will appear in the scheduled live story and lobby.
`spatial_audio_format` enum {ambiX_4}	Denotes the format of the spatial audio stream. When unspecified audio is presumed to be mono or stereo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	The status of the broadcast. A `LIVE_NOW` broadcast is currently live and visible to users. An `UNPUBLISHED` broadcast is in preparation; it's not visible to other users, and it may be automatically deleted after several hours in this state. (Consider using the `SCHEDULED` states to create a planned, future broadcast.)
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Set this parameter to the stereoscopic mode for this video.
`stop_on_delete_stream` boolean	Set this to true if stream should be stopped when deleteStream RTMP command received.
`title` string	The title of the live video. Maximum 254 characters.

Type de retour

This endpoint supports read-after-write and will read the node represented by id in the return type.

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,

dash_ingest_secondary_urls: List [

string

event_id: numeric string,

}

Error Codes

Erreur	Description
200	Permissions error
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
102	Session key invalid or no longer valid
190	Invalid OAuth 2.0 Access Token
1000	Invalid time for an event.
1005	Fail to upload cover photo.

Mise à jour

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Suppression

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.