versión API Graph

Vídeos en directo de grupos

Para obtener más información sobre la API de vídeo en directo, consulta nuestros documentos sobre los vídeos en directo.

Creación

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

/{group-id}/live_videos

Cuando se hacen publicaciones en este perímetro, se creará un objeto LiveVideo.

Parámetros

Nombre	Descripción
`app_attribution_tag` Cadena numérica o entero	Etiqueta de atribución de los vídeos en directo que se mostrará en el feed.
`attribution_app_id` Cadena numérica o entero	Identificador de la aplicación de atribución.
`content_tags` Lista<cadena numérica>	Etiquetas que describen el contenido del vídeo. Utiliza el extremo de búsqueda con `type=adinterest` para obtener posibles identificadores. Ejemplo de consulta: /search?type=adinterest&q=sunsets
`description` Cadena UTF-8	Descripción del vídeo en directo. Admite emoticonos.
`encoding_settings` Cadena	Identificador del grupo de configuración de codificación que la persona que transmite utiliza para esta transmisión. Actualmente este parámetro solo se usa para transmisiones en directo de 360 grados. El valor que se pasará a este parámetro es el valor de la clave `identifier` del valor predefinido de configuración de codificación. Los valores predefinidos de codificación se pueden buscar con una consulta al extremo de la API Graph `/broadcaster_encoding_settings` (consulta `GET`).
`event_params` Entero	Marca de tiempo UNIX del momento en que la persona que transmite tiene previsto transmitir en directo.
`fisheye_video_cropped` Booleano	Indica si el vídeo de ojo de pez único está recortado o no.
`front_z_rotation` Flotante	Rotación z frontal en grados del vídeo de ojo de pez único.
`game_id` Cadena numérica o entero	Establece sobre qué juego trata este vídeo. Utiliza el extremo de búsqueda con `type=game` para obtener posibles identificadores. Ejemplo de consulta: /search?type=game&=pubg
`game_specs` Parámetro de especificaciones de juegos	Establece metadatos que representan el juego que se debe atribuir.
`is_spherical` Booleano	Marca que indica que la transmisión es una transmisión en directo de 360 grados.
`live_encoders` Lista<cadena numérica o entero>	Codificadores en directo que transmitirán en este vídeo en directo.
`original_fov` Entero de 64 bits	Campo original de visión de la cámara.
`post_surfaces_blacklist` Lista<enumeración{1, 2, 3, 4, 5}>	Lista de ubicaciones no autorizadas en las que no aparecerá la publicación (para la experiencia de solo feed).
`privacy` Parámetro de privacidad	Privacidad de este vídeo en directo.
`projection` Enumeración{EQUIRECTANGULAR, CUBEMAP}	Marca que indica la proyección esperada para transmisiones en directo de 360 grados. El valor predeterminado es EQUIRECTANGULAR.
`save_vod` Booleano	Indica si se deben guardar los datos del vídeo para consumirlos posteriormente en formato VOD. El valor predeterminado es “true”. (Nota: Solo se puede establecer en el momento de la creación)
`schedule_custom_profile_image` Imagen	Imagen personalizada que aparecerá en la historia en directo programada y el lobby.
`spatial_audio_format` Enumeración{ambiX_4}	Indica el formato de la transmisión de sonido espacial. Cuando se presupone que el sonido no especificado es mono o estéreo.
`status` Enumeración {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	Estado de la transmisión. Una transmisión `LIVE_NOW` está actualmente en directo y es visible para los usuarios. Una transmisión `UNPUBLISHED` está en preparación y no es visible para otros usuarios. Una transmisión no publicada se puede eliminar automáticamente después de varias horas en este estado. Considera la posibilidad de utilizar los estados programados para crear una transmisión planificada y futura.
`stereoscopic_mode` Enumeración {MONO, LEFT_RIGHT, TOP_BOTTOM}	Establece esta marca en el modo estereoscópico para este vídeo.
`stop_on_delete_stream`	Establece este parámetro en `true` si la transmisión se debe detener cuando se reciba el comando RTMP `deleteStream`.
`title` Cadena UTF-8	Título del vídeo en directo. Admite emoticonos.

Tipo de devolución

Este extremo admite la operación de lectura después de la escritura y leerá el nodo que representa id en el tipo de devolución.

Estructura { 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

Lectura

Funciones

Nombre	Descripción
API de grupos	Se trata de una función que requiere la revisión de la aplicación.

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 la guía de uso de la API Graph.

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}>	Permite especificar qué tipo de vídeos en directo se deben devolver. Si no se indica ningún valor, se devuelven todos los tipos de estado.
`source` Enumeración{target, owner}	Valor predeterminado: `target` Origen del que se deben consultar los vídeos. Por ejemplo, `target` obtiene la transmisión de vídeos en un grupo. Los vídeos en directo de grupos SOLO admiten `target`.

broadcast_status

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

Permite especificar qué tipo de vídeos en directo se deben devolver. Si no se indica ningún valor, se devuelven todos los tipos de estado.

source

Enumeración{target, owner}

Valor predeterminado: target

Origen del que se deben consultar los vídeos. Por ejemplo, target obtiene la transmisión de vídeos en un grupo. Los vídeos en directo de grupos SOLO admiten target.

Campos

Una lectura desde este perímetro devolverá un resultado en formato JSON:

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

data

Lista de campos de 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

Esta operación no se puede realizar en este extremo.

Eliminación

Esta operación no se puede realizar en este extremo.