API Graph versión

Videos en vivo de grupos

Para obtener más información sobre la API de video en vivo, consulta nuestra documentación sobre video en vivo.

Crear

Puedes hacer una solicitud POST al perímetro live_videos desde las siguientes rutas:

/{group-id}/live_videos

Cuando envíes una solicitud POST a este perímetro, se creará un video en vivo.

Parámetros

Nombre	Descripción
`app_attribution_tag` cadena numérica o entero	Una etiqueta de atribución para videos en vivo que se mostrará en el feed.
`attribution_app_id` cadena numérica o entero	Identificador de la app de atribución.
`content_tags` lista <cadena numérica>	Etiquetas en las que se describe el contenido del video. Usa el punto de conexión de búsqueda con `type=adinterest` para obtener los posibles identificadores. Ejemplo de consulta: /search?type=adinterest&q=sunsets
`description` cadena UTF-8	La descripción del video en vivo. Admite emojis.
`encoding_settings` cadena	Identificador del grupo de configuración de codificación que usa el presentador en esta transmisión. Por el momento, el parámetro solo se usa en transmisiones 360° en vivo. El valor que se debe pasar en este parámetro es el valor de la clave `identifier` del valor predefinido de la configuración de codificación. Para ver los valores predefinidos de codificación, consulta el punto de conexión `/broadcaster_encoding_settings` de la API Graph (consulta `GET`).
`event_params` entero	Marca de tiempo UNIX del momento cuando el presentador planea transmitir en vivo.
`fisheye_video_cropped` booleano	Indica si el video simple con objetivo ojo de pez se recortó o no.
`front_z_rotation` valor de coma flotante	La rotación z delantera en grados del video simple con objetivo ojo de pez.
`game_id` cadena numérica o entero	Establece de qué juego se trata este video. Usa el punto de conexión de búsqueda con `type=game` para obtener los posibles identificadores. Ejemplo de consulta: /search?type=game&=pubg
`game_specs` parámetro de especificaciones del juego	Establece los metadatos que representan el juego que se deberá atribuir.
`is_spherical` booleano	Marca que indica que se trata de una transmisión 360° en vivo.
`live_encoders` lista <cadena numérica o número entero>	Codificadores en vivo que transmitirán en este video en vivo.
`original_fov` int64	Campo original de la vista de la cámara.
`post_surfaces_blacklist` lista <enumeración{1, 2, 3, 4, 5}>	Una lista negra de las ubicaciones en las que no aparecerá la publicación; solo para experiencias de feed.
`privacy` Parámetro de privacidad	Privacidad de este video en vivo.
`projection` enumeración {EQUIRECTANGULAR, CUBEMAP}	Marca que indica la proyección esperada de las transmisiones 360° en vivo. El valor predeterminado es EQUIRECTANGULAR.
`save_vod` booleano	Indica si los datos del video se deberían guardar o no para consumo posterior en formato VOD. El valor predeterminado es "true" (Nota: Solo se puede configurar durante la creación).
`schedule_custom_profile_image` imagen	Imagen personalizada que aparecerá en la historia en vivo programada y en la sala.
`spatial_audio_format` enumeración {ambiX_4}	Indica el formato de la transmisión de audio espacial. Si no se especifica, se asume que es mono o estéreo.
`status` enumeración {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	El estado de la transmisión. En este momento, hay una transmisión `LIVE_NOW` en vivo y los usuarios pueden verla. Hay una transmisión `UNPUBLISHED` en preparación y los otros usuarios no pueden verla. Es posible que una transmisión sin publicar se elimine automáticamente después de varias horas en este estado. Considera usar los estados de transmisión programada para crear una transmisión planificada para el futuro.
`stereoscopic_mode` enumeración {MONO, LEFT_RIGHT, TOP_BOTTOM}	Configura esta marca en el modo estereoscópico en relación con este video.
`stop_on_delete_stream`	Configura este parámetro en `true` si la transmisión debe detenerse cuando se recibe el comando RTMP `deleteStream`.
`title` cadena UTF-8	El título del video en vivo. Admite emojis.

Tipo de devolución

Este punto de conexión admite lectura después de escritura y lee el nodo representado por id en el tipo de devolución.

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

Reglas de validación

Error	Descripción
100	Parámetro no válido
200	Error de permisos

Leer

Funciones

Nombre	Descripción
API de grupos	Esta es una función que requiere revisión de apps.

Ejemplo:

/* 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 */

Obtén más información sobre la API Graph en nuestra guía sobre el uso de esta API.

Parámetros

Nombre Descripción

Nombre	Descripción
`broadcast_status` lista <enumeración {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	Te permite especificar el tipo de videos en vivo que se devuelve. Si no se especifica ningún valor, se devuelven todos los tipos de estado.
`source` enumeración {target, owner}	Valor predeterminado: `target` El origen en el cual los videos se deberían consultar. P. ej., `target` obtiene videos que se transmiten a un grupo. Los videos en vivo de grupos SOLO admiten `target`.

broadcast_status

lista <enumeración {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>

Te permite especificar el tipo de videos en vivo que se devuelve. Si no se especifica ningún valor, se devuelven todos los tipos de estado.

source

enumeración {target, owner}

Valor predeterminado: target

El origen en el cual los videos se deberían consultar. P. ej., target obtiene videos que se transmiten a un grupo. Los videos en vivo de grupos SOLO admiten target.

Campos

La lectura desde este perímetro devuelve un resultado con formato JSON:

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

data

Una lista de campos LiveVideo.

paging

Para obtener más detalles sobre la paginación, consulta la guía de la API Graph.

Reglas de validación

Error	Descripción
200	Error de permisos

Actualización

No es posible realizar esta operación en este punto de conexión.

Eliminación

No es posible realizar esta operación en este punto de conexión.