Personalización del diseño de vídeo para archivos compuestos

Puedes usar la API REST de Video de Vonage para personalizar el diseño de los videos en un archivo.

Esta función se aplica a los archivos compuestos, no a los archivos individuales. Para obtener información general sobre los archivos, consulte la sección Archivo guía.

Visión general

Por defecto, los archivos organizan los vídeos de la sesión en mosaico. Por ejemplo, a continuación se ilustra la disposición cuando hay 1, 2, 4 o 5 secuencias en una sesión:

Esto se conoce como "mejor ajuste" diseño. También puede elegir entre otras disposiciones predefinidas.

Para los otros diseños, asigna un nombre de clase a cada flujo de Vonage Video para determinar cómo aparecerá en el diseño. (Consulta Tipos de diseño predefinidos.)

También puede definir sus propios diseños personalizados utilizando CSS. Consulte Definición de diseños personalizados.

Por defecto, el archivo compuesto es 640x480 píxeles (SD horizontal, relación de aspecto 4:3). Los vídeos individuales de Vonage se organizan en rectángulos contenedores dentro del vídeo grabado.

Si la relación de aspecto del vídeo de un flujo individual no coincide con la del contenedor (por ejemplo, si es un vídeo HD o un vídeo para compartir pantalla), se encasilla para que quepa en el contenedor. Por ejemplo, la siguiente ilustración muestra una distribución óptima con dos vídeos SD apaisados (4:3) (1 y 4) y dos vídeos HD apaisados (16:9) (2 y 3):

También puede configurar un archivo compuesto para que utilice un 480x640 (SD vertical, relación de aspecto 3:4), 1280x720 (HD horizontal, relación de aspecto 16:9), 720x1280 (HD vertical, relación de aspecto 9:16), 1920x1080 (FHD horizontal, relación de aspecto 16:9) o 1080x1920 (retrato FHD, relación de aspecto 9:16) cuando llame al botón iniciar archivo de la API REST de Video de Vonage. Es posible que desees usar una relación de aspecto vertical al grabar archivos que incluyan transmisiones de video desde dispositivos móviles (que a menudo usan la relación de aspecto vertical).

Para utilizar esta función:

Especifique el tipo de presentación para el archivo compuesto - véase Especificar el tipo de diseño inicial y Cambiar dinámicamente el tipo de diseño mientras se graba la sesión.
Asigna clases de diseño a las transmisiones de Vonage Video.

También puede definir su propio diseños personalizados.

Especificar el tipo de diseño inicial

Cuando inicias el archivo de una sesión, mediante la API REST de Vonage Video, puedes especificar, de manera opcional, el tipo de diseño de archivo inicial.

Establezca la siguiente URL para la solicitud POST:

/v2/project/{appId}/archive

Fije el Content-Type a application/json y establecer el layout type como una propiedad de los datos JSON enviados en la solicitud POST:

{
  "sessionId": "2_MX44NTQ1MTF--bm1kTGQ0RjVHeGNQZE51VG5scGNzdVl0flB-",
  "layout": {
    "type": "pip"
  },
  "name" : "archive_name",
  "outputMode" : "composed"
}

Si utiliza un diseño personalizado, consulte Definición de diseños personalizados - fijar el type propiedad a custom y pasar la hoja de estilos como una propiedad adicional - stylesheet:

{
  "sessionId": "2_MX44NTQ1MTF--bm1kTGQ0RjVHeGNQZE51VG5scGNzdVl0flB-",
  "layout": {
    "type": "custom",
    "stylesheet": "stream.instructor {position: absolute; width: 100%;  height:50%;}"
  },
  "name" : "archive_name",
  "outputMode" : "composed"
}

También puede especificar el tipo de presentación que se utilizará cuando haya un flujo de pantalla compartida en la sesión configurando la opción screenshareType propiedad del layout propiedad - ver diseños de pantalla compartida:

{
  "sessionId": "2_MX44NTQ1MTF--bm1kTGQ0RjVHeGNQZE51VG5scGNzdVl0flB-",
  "layout": {
    "type": "bestFit",
    "screenshareType": "pip"
  },
  "name" : "archive_name",
  "outputMode" : "composed"
}

Autenticar la llamada REST mediante un token JWT. véase Autenticación API REST de Vonage Video:

Authorization: Basic base64(APP_ID:API_SECRET)

La solicitud devuelve un código de respuesta de error 400 si especifica un tipo no válido.

También puede especificar el tipo de presentación inicial al iniciar una grabación mediante la opción SDK para servidores:

Si no especifica un tipo de presentación inicial, el archivo compuesto utiliza el tipo de presentación Mejor ajuste.

Si especificas cualquier otro tipo de diseño, asegúrate de aplicar las clases de diseño apropiadas para los flujos en la sesión de Vonage Video.

Véase Asignación de clases de diseño a transmisiones de Vonage Video y Tipos de diseño predefinidos.

Cambio dinámico del tipo de presentación durante el archivado

Puede cambiar dinámicamente el tipo de presentación llamando a la función /archive/layout API REST.

Haga una petición PUT a la siguiente URL:

/v2/project/{appId}/archive/{archiveId}/layout

Fije el Content-Type a application/json e incluir el diseño type como una propiedad de los datos JSON en la solicitud PUT:

{
  "type": "pip"
}

Si utiliza un diseño personalizado fijar el type propiedad a custom y pasar la hoja de estilos como una propiedad adicional - stylesheet:

{
  "type": "custom",
  "stylesheet": "stream.instructor {position: absolute;  width: 100%;  height:50%;}"
}