Canal

En Servicios multimedia de Azure (AMS), la entidad Canal representa una canalización para procesar contenido de streaming en vivo. Los canales reciben el flujo de entrada en directo de dos maneras posibles:

  • Un codificador en directo local envía varias velocidades de bits RTMP o Smooth Streaming (MP4 fragmentadas) al canal. Puede usar los siguientes codificadores en directo que generan Smooth Streaming con velocidad de bits múltiple: MediaExcel, Imagine Communications, Ateme, Envivio, Cisco and Elemental. Los siguientes codificadores en directo generan RTMP: Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek y Tricaster. Las secuencias tomadas pasan a través de canales sin más procesamiento. Cuando se solicita, Media Services entrega la secuencia a los clientes.

  • Una secuencia de velocidad de bits única (en uno de los siguientes formatos: RTP (MPEG-TS), RTMPo Smooth Streaming (MP4 fragmentado) se envía al Channel que está habilitado para realizar la codificación en directo con Media Services. A continuación, el Channel realiza la codificación en directo de la secuencia de velocidad de bits única entrante a una secuencia de vídeo de velocidad de bits múltiple (adaptable). Cuando se solicita, Media Services entrega la secuencia a los clientes.

A partir de la versión 2.10 de Media Services, al crear un canal, puede especificar la forma en que desea que este reciba el flujo de entrada y si quiere que el canal realice la codificación en directo de la secuencia. Tiene dos opciones:

Para más información sobre Live Streaming y administración de canales, consulte Entrega de streaming en vivo con Azure Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración para el desarrollo de api REST de Media Services y conexión a Media Services con la API REST de Media Services.

En este tema encontrará un resumen de la entidad Channel y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

Entidad Canal

La entidad Channel contiene las siguientes propiedades.

Propiedad Tipo Descripción
Id

Solo lectura. Establecido por Servicios multimedia.
Edm.String Identificador del canal, asignado durante la creación. El formato es:

nb:chid:UUID:<GUID>.
Name Edm.String Nombre del canal.

1. Debe ser único dentro de su cuenta de Media Services.
2. Longitud máxima = 32 caracteres.
3. No se pueden contener espacios.
4. Guiones y caracteres alfanuméricos únicamente.
5. No se puede comenzar ni terminar con un guión.
Created

Solo lectura. Establecido por Servicios multimedia.
Edm.DateTime Valor de fecha y hora UTC que indica el momento en que se creó.
Description Edm.String Descripción proporcionada por el usuario. La longitud máxima es de 256 caracteres.
LastModified

Solo lectura. Establecido por Servicios multimedia.
Edm.DateTime Fecha y hora de la última actualización en el canal.
State

Solo lectura. Establecido por Servicios multimedia.
Edm.String Estado actual del canal. Los valores posibles son:

- Stopped. Este es el estado inicial del canal después de su creación. En este estado, se pueden actualizar las propiedades del canal pero no se permite el streaming.
- Starting. El canal se está iniciando. No se permiten actualizaciones ni streaming durante este estado. Si se produce un error, el canal vuelve al estado Detenido.
- Running. El canal es capaz de procesar secuencias en directo.
- Stopping. el canal se está deteniendo. No se permiten actualizaciones ni streaming durante este estado.
- Deleting. El canal se está eliminando. No se permiten actualizaciones ni streaming durante este estado.
Input ChannelInput ComplexType Configuración de entrada (introducción) del canal.
Output ChannelOutput ComplexType Configuración de salida del canal.
Preview ChannelPreview ComplexType Configuración de vista previa del canal.
CrossSiteAccessPolicies CrossSiteAccessPolicies Directivas de acceso entre sitios.
Programs

Solo lectura. Establecido por Servicios multimedia.
Colección de Programass. Referencia a la colección de programas asociados al canal.
EncodingType Edm.String Optional. Describe la configuración del canal. Los valores permitidos son:

- None : este es el valor predeterminado. Al seleccionar este valor, la secuencia entrante pasa a la salida sin ninguna codificación (este es el comportamiento de un canal antes de la versión 2.10).
- Standard: la secuencia de velocidad de bits única entrante se envía al canal y se transcodifica en una secuencia de velocidad de bits múltiple mediante valores preestablecidos del sistema.
Encoding ComplexType de codificación Configuración del codificador en directo de Azure.
Slate Claqueta Esta configuración solo se admite cuando Encoding Type el valor del canal está establecido Standarden .

Puede señalarse al codificador en directo del canal que cambie a una imagen de pizarra. También puede se le puede indicar que finalice una pizarra en curso.

El codificador en directo puede configurarse para cambiar a una careta y enmascarar la señal de vídeo entrante en determinadas situaciones; por ejemplo, durante una pausa publicitaria. Si no se ha configurado ninguna pizarra de este tipo, el vídeo de entrada no se enmascara durante esa pausa.

ChannelInput ComplexType

Nombre Tipo Descripción
KeyFrameInterval Edm.Time Este valor se omite si EncoderType está establecido en Standard.

Cuando se usa un codificador en directo local para generar una secuencia de velocidad de bits múltiple, el intervalo de fotogramas clave especifica la duración de GOP (como lo usa ese codificador externo). Cuando el canal recibe esta secuencia entrante, puede entregar la secuencia en directo a las aplicaciones cliente de reproducción en cualquiera de los siguientes formatos: Smooth Streaming, DASH y HLS. Cuando se realiza el streaming en vivo, HLS siempre se empaqueta dinámicamente. De forma predeterminada, Servicios multimedia calcula automáticamente la proporción de empaquetado del segmento HLS (fragmentos por segundo) según el intervalo de fotogramas clave, conocido también como grupo de imágenes (GOP), que se recibe desde el codificador en directo.
StreamingProtocol

Solo lectura.
Edm.String Después de establecer el tipo de codificador, puede establecer un protocolo de introducción.

Si se establece Noneen Encoder Type , las opciones válidas son:

- MP4 fragmentado con velocidad de bits múltiple (Smooth Streaming)
- RTMP de velocidad de bits múltiple

Encoder Type Cuando se establece Noneen , es válido, pero no es deseable, para que se envíe una secuencia en vivo RTMP o Smooth Streaming de velocidad de bits única. El canal no realiza ningún procesamiento sobre la secuencia; por tanto, esta se pasará, pero las aplicaciones cliente obtendrán una secuencia de velocidad de bits única.

Si se establece Standarden Encoder Type , las opciones válidas son:

1. Mp4 fragmentado de velocidad de bits única (Smooth Streaming)
2. Velocidad de bits única RTMP
3. RTP (MPEG-TS): Flujo de transporte MPEG-2 a través de RTP.
AccessControl ChannelInputAccessControl ComplexType Configuración del control de acceso de entrada del canal.
Endpoints

Solo lectura.
ChannelEndpoint ComplexType Extremos de entrada del canal.

Un canal proporciona extremos de entrada (Direcciones URL de entrada) que, a continuación, se usan para introducir la secuencia en directo. El canal recibe las secuencias de entrada en directo y pone las secuencias de salida a disposición para el streaming través de uno o varios extremos de streaming.

ChannelPreview ComplexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales que están habilitados para la codificación en directo.

Nombre Tipo Descripción
AccessControl ChannelPreviewAccessControl ComplexType Configuración del control de acceso de vista previa del canal.
Endpoints

Solo lectura.
ChannelEndpoint ComplexType Extremos de vista previa del canal.

ChannelInputAccessControl ComplexType

Nombre Tipo Descripción
IP IPAccessControl Direcciones IP permitidas para conectar con los extremos de entrada del canal.
Las direcciones IP deben tener uno de los siguientes formatos: Dirección IpV4 con 4 números, intervalo de direcciones CIDR.

ChannelPreviewAccessControl ComplexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales que están habilitados para la codificación en directo.

Nombre Tipo Descripción
IP IPAccessControl Direcciones IP permitidas para conectar con los extremos de entrada del canal.
Las direcciones IP deben tener uno de los siguientes formatos: Dirección IpV4 con 4 números, intervalo de direcciones CIDR

IPAccessControl

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales que están habilitados para la codificación en directo.

Nombre Tipo Descripción
Allow IPRange ComplexType Direcciones IP permitidas para conectar con los extremos de entrada del canal. Nota: Establecer este valor en NULL permite que todas las direcciones de origen IP se conecten. Establecerlo en una cadena vacía (“”) no permite a nadie conectarse.

IPRange ComplexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales que están habilitados para la codificación en directo.

Nombre Tipo Descripción
Name Edm.String Nombre descriptivo para este intervalo IP.
Address Edm.String Dirección IP base para la representación de subred (por ejemplo, 192.168.0.1).
SubnetPrefixLength Edm.Int32 Número de bits importantes para la máscara de subred (por ejemplo, en la dirección IP 192.168.0.1/24, 24 representa el número de bits importantes).

ChannelEndpoint ComplexType

Nombre Tipo Descripción
Protocol Edm.String Protocolo de extremo de streaming del canal.
Url Edm.String Dirección URL de extremo de streaming del canal.

ChannelOutput ComplexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

Nombre Tipo Descripción
Hls ChannelOutputHls ComplexType Configuración específica de HLS.

ChannelOutputHls ComplexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

Nombre Tipo Descripción
FragmentsPerSegment Edm.Int16 Cantidad de fragmentos por segmento HTTP Live Streaming (HLS).

Codificación complexType

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

Nombre Tipo Descripción
AdMarkerSource Edm.String Puede especificar el origen de las señales de los marcadores de anuncio. El valor predeterminado es Api, que indica que el codificador en directo dentro del canal debe escuchar a un asincrónico Ad Marker API. La otra opción válida es Scte35 (solo se permite si se establece RTP (MPEG-TS). el protocolo de streaming de ingesta en Cuando Scte35 se especifica, el codificador analizará SCTE-35 las señales de la secuencia RTP (MPEG-TS) de entrada.
IgnoreCea708ClosedCaptions Edm.bool Optional. Marca opcional que indica al codificador en directo que omita cualquier dato de los subtítulos CEA 708 insertado en el vídeo entrante. Si la marca está establecida en false (valor predeterminado), el codificador detectará y volverá a insertar los datos de CEA 708 en las secuencias de vídeo salientes.
VideoStream VideoStream Optional. Describe la secuencia de vídeo de entrada. Si este campo no se especifica, se usa el valor predeterminado. Este valor solo se permite si el protocolo de streaming de entrada está establecido en RTP (MPEG-TS).
AudioStreams AudioStreams Optional. Describe las secuencias de audio de entrada. Si este campo no se especifica, se aplican los valores predeterminados. Este valor solo se permite si el protocolo de streaming de entrada está establecido en RTP (MPEG-TS).
SystemPreset Edm.String Especifica el codificador preestablecido para su uso para este canal. Actualmente, el único valor admitido es Default720p (predeterminado).

Para obtener más información, consulte SystemPreset.

SystemPreset

Default720p especifica para codificar el vídeo en las 6 capas siguientes.

Velocidad de bits Ancho Alto Fotogramas/seg. máx. Perfil Nombre secuencia salida
3500 1280 720 30 Alto Video_1280x720_3500kbps
2200 960 540 30 Alto Video_960x540_2200kbps
1350 704 396 30 Alto Video_704x396_1350kbps
850 512 288 30 Alto Video_512x288_850kbps
550 384 216 30 Alto Video_384x216_550kbps
200 340 192 30 Alto Video_340x192_200kbps

El audio se codifica como estéreo AAC-LC a 64 kbps, con una frecuencia de muestreo de 44,1 kHz.

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

VideoStream

Describe la secuencia de vídeo de entrada. Si este campo no se especifica, se usa el valor predeterminado. Este valor solo se permite si el protocolo de streaming de entrada está establecido en RTP (MPEG-TS).

Nombre Tipo Descripción
Index Edm.Int1 Índice basado en cero que especifica qué secuencia de vídeo de entrada debe procesar el codificador en directo dentro del canal. Esta configuración solo se aplica si el protocolo de streaming de ingesta es RTP (MPEG-TS).

El valor predeterminado es cero. Se recomienda enviar una secuencia de transporte de un solo programa (SPTS). Si la secuencia de entrada contiene varios programas, el codificador en directo analiza la tabla de asignación de programas (PMT) en la entrada, identifica las entradas con un nombre de tipo de secuencia MPEG-2 Video o H.264 y las organiza en el orden especificado en la tabla PMT. A continuación, se usa el índice basado en cero para seleccionar la entrada concreta en esa disposición.
Name Edm.String Optional. Etiqueta descriptiva para esta secuencia de vídeo de entrada.

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

AudioStreams

Describe las secuencias de audio de entrada. Si este campo no se especifica, se aplican los valores predeterminados. Este valor solo se permite si el protocolo de streaming de entrada está establecido en RTP (MPEG-TS).

Nombre Tipo Descripción
Index Edm.Int16 Se recomienda enviar una secuencia de transporte de un solo programa (SPTS). Si la secuencia de entrada contiene varios programas, el codificador en directo del canal analiza la tabla de asignación de programas (PMT) en la entrada, identifica las entradas con un nombre de tipo de secuencia MPEG-2 AAC ADTS, AC-3 System-A, AC-3 System-B, MPEG-2 Private PES, MPEG-1 Audio o MPEG-2 Audio y las organiza en el orden especificado en la tabla PMT. A continuación, se usa el índice basado en cero para seleccionar la entrada concreta en esa disposición.
Name Edm.String Optional. Etiqueta descriptiva para esta secuencia de audio de entrada.
Language Edm.String Optional. El identificador de idioma de la secuencia de audio, conforme a ISO 639-2, por ejemplo, ENG. Si no aparece, el valor predeterminado es UND (sin definir).

Pueden especificarse hasta 8 conjuntos de secuencias de audio si la entrada al canal es MPEG-2 TS a través de RTP. Sin embargo, no puede haber dos entradas con el mismo valor para Índice.

Puede haber hasta 8 conjuntos {Index, Name, Language} especificados si la entrada para el codificador es MPEG-2 TS a través de RTP. Sin embargo, no puede haber dos entradas con el mismo valor para Índice. Si la entrada para el codificador es RTMP o HTTP (Smooth Streaming), solo puede haber una secuencia de audio en la entrada.

Claqueta

Esta configuración solo se admite cuando Encoding Type el valor del canal está establecido en Standard.

Puede señalarse al codificador en directo del canal que cambie a una imagen de pizarra. También puede se le puede indicar que finalice una pizarra en curso.

El codificador en directo puede configurarse para cambiar a una careta y enmascarar la señal de vídeo entrante en determinadas situaciones; por ejemplo, durante una pausa publicitaria. Si no se ha configurado ninguna pizarra de este tipo, el vídeo de entrada no se enmascara durante esa pausa.

Nombre Tipo Descripción
InsertSlateOnAdMarker Edm.Bool Cuando se establece en True, esta configuración define el codificador en directo para que inserte una careta durante una pausa publicitaria. El valor predeterminado es true.
DefaultSlateAssetId Edm.String Optional. Especifica el identificador de recurso del recurso de Media Services que contiene la imagen de pizarra. El valor predeterminado es null.

Antes de crear el canal, se debe cargar la careta, con una resolución máxima de 1920 x 1080, en formato JPEG y al menos 3 MB de tamaño, como un recurso dedicado (ningún otro archivo debe estar en este recurso). El nombre de archivo debe tener una extensión *.jpg, y este AssetFile debe marcarse como el archivo principal para ese recurso. Este recurso no se puede cifrar en el almacenamiento.

Si no se especifica el identificador de recurso de pizarra predeterminado y la inserción de pizarra en el marcador de anuncios se establece en true, se usará una imagen predeterminada de Azure Media Services para enmascarar el flujo de entrada.

Para obtener información más detallada sobre este tipo y sus propiedades, vea Información general de los canales habilitados para la codificación en directo.

Crear canales

Para crear canales, puede usar una solicitud HTTP POST y especificar valores de propiedad.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels> HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

En el cuerpo de la solicitud siguiente se muestra cómo crear un canal habilitado para la codificación en directo.

{  
   "Id":null,  
   "Name":"testchannel001",     
   "Description":"",  
   "EncoderType":"Standard",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "Input":  
   {  
      "StreamingProtocol":"RTPMPEG2TS",  
      "AccessControl":  
      {  
         "IP":  
         {  
         "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   },  
   "Encoding":  
   {  
      "SystemPreset":"Default720p",  
      "IgnoreCea708ClosedCaptions": false,  
      "AdMarkerSource": "Api",
      "VideoStream":  
      {  
         "Index":1,  
         "Name":"Video stream"  
      },  
      "AudioStreams":  
      [  
         {  
            "Index":0,  
            "Name":"English audio stream",  
            "Language":"ENG"  
         },  
         {  
            "Index":1,  
            "Name":"Spanish audio stream",  
            "Language":"SPA"  
         }  
      ]  
   },  
   "EncodingType": "Standard",  
   "Slate":  
   {  
      "InsertOnAdMarker":true,  
      "DefaultSlateAssetId": "nb:cid:UUID:01234567-0123-0123-0123-01234567"  
   },  
   "Preview":  
   {  
      "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   }  
}  
  

En el cuerpo de la solicitud siguiente se muestra cómo crear un canal en la cuenta que no está habilitada para la codificación en directo.

{  
"Id":null,  
"Name":"testchannel001",  
"Description":"",  
"Created":"0001-01-01T00:00:00",  
"LastModified":"0001-01-01T00:00:00",  
"State":null,  
"Input":  
   {  
   "KeyFrameInterval":null,  
   "StreamingProtocol":"FragmentedMP4",  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
   "Endpoints":[]  
   },  
"Preview":  
   {  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
      "Endpoints":[]  
   },  
"Output":  
   {  
   "Hls":  
      {  
         "FragmentsPerSegment":1  
      }  
   },  
"CrossSiteAccessPolicies":  
   {  
      "ClientAccessPolicy":null,  
      "CrossDomainPolicy":null  
   }  
}  

Si es correcto, se devolverá un código de estado 202 Accepted junto con una representación de la entidad creada en el cuerpo de respuesta.

El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Iniciar canales

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Start HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Detener canales

Puede detener un canal únicamente cuando se encuentra en el estado En ejecución y todos los programas del canal se han detenido.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Enumerar canales

Para recuperar canales, use una solicitud GET HTTP.

Método URI de solicitud Versión HTTP
GET Obtener todos los canales:

<https:// accountname.restv2>.<location.media.azure.net/api/Channels>

Obtener un canal específico:

<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')
HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

GET https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si se ejecuta correctamente, esta operación devuelve un código de estado 200 OK y una lista de todos los canales creados en la cuenta de Media Services.

Restablecer canales

Restablece el estado del canal en tiempo de ejecución mantenido durante el streaming de una presentación en directo y permite reutilizar un canal en caso de que se restablezca la presentación o se vuelva a configurar el codificador. Detenga todos los programas antes de llamar al restablecimiento. Puede llamar al restablecimiento de un canal que se encuentre en el estado En ejecución.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Reset HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Actualizar canales

Actualiza las propiedades de un canal existente. El canal debe encontrarse en el estado Detenido.

Método URI de solicitud Versión HTTP
PATCH/PUT/MERGE

Para obtener más información acerca de estas operaciones, vea PATCH, PUT, MERGE.
<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid') HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

PATCH https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Cuerpo de la solicitud:

"Encoding":{"IgnoreCea708ClosedCaptions": true}  

Si la actualización se completa de manera sincrónica, devuelve un código de estado 204 No Content; de lo contrario, devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Iniciar anuncio

El codificador en directo se puede indicar para iniciar un anuncio o una interrupción comercial mediante una solicitud HTTP POST y especificar los valores de propiedad de en la entidad StartAdvertisement Entity en el cuerpo de la solicitud.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement HTTP/1.1

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Entidad StartAdvertisement

Esta entidad representa la API de inicio del anuncio: es una llamada asincrónica al codificador en directo para que inserte pausas comerciales o publicitarias en la secuencia de salida.

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Nombre Tipo Descripción
duration Edm.Duration La duración, en segundos, de la pausa comercial. Para que se inicie la pausa comercial, este debe ser un valor positivo distinto de cero. Si hay una pausa comercial en curso, la duración está establecida en cero y el identificador de pila coincide con el de dicha pausa comercial, la pausa se cancela.
cueId Edm.Int Identificador único para la pausa comercial, que utilizará la aplicación de bajada para adoptar las acciones oportunas. Debe ser un entero positivo.
showSlate Edm.Bool Optional. indica al codificador en directo dentro del canal que debe cambiar a la careta predeterminada durante la pausa comercial (y enmascarar la fuente de vídeo entrante). El valor predeterminado es False.

La imagen usada será la especificada a través de la propiedad de identificador de recurso de pizarra predeterminada en el momento de la creación del canal.

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/StartAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Cuerpo

{  
   "duration":"PT45S",  
   "cueId":"67520935",  
   "showSlate":"true"  
}  
  

Si es correcto, se devuelve un código de estado 202 Accepted.

Finalizar anuncio

Puede señalar al codificador en directo que finalice una pausa comercial o publicitaria mediante una solicitud HTTP POST.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement HTTP/1.1

Esta llamada solo debería invocarse cuando hay un anuncio en curso.

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/EndAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted.

Mostrar pizarra

indica al codificador en directo dentro del canal que debe cambiar a la careta predeterminada durante la pausa comercial (y enmascarar la fuente de vídeo entrante). El valor predeterminado es False. La imagen usada será la especificada a través de la propiedad de identificador de recurso de pizarra predeterminada en el momento de la creación del canal.

Use las propiedades de ShowSlate Entity en el cuerpo de la solicitud HTTP.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate HTTP/1.1

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Entidad ShowSlate

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Nombre Tipo Descripción
duration Edm.Duration La duración, en segundos, de la careta. Para iniciar la pizarra, este debe ser un valor positivo distinto de cero. Si hay una careta en curso y se especifica una duración de cero, se finalizará esa careta en curso.
assetId Edm.String Especifica el identificador de recurso del recurso de Media Services que contiene la imagen de pizarra.

Antes de crear el canal, se debe cargar la careta, con una resolución de 1920 x 1080, en formato JPEG y al menos 3 MB de tamaño, como un recurso dedicado (ningún otro archivo debe estar en este recurso).

Se puede señalar al codificador para que cambie a cualquier careta arbitraria (y no solo a la especificada mediante la propiedad DefaultSlateAssetId en el momento de crear el canal).

Si la propiedad DefaultSlateAssetId, y AssetId no se especifica, se utilizará la imagen DefaultSlateAssetId para enmascarar la secuencia de entrada. Para obtener más información, consulte Pizarra.

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/ShowSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Cuerpo

{  
   "duration":"PT45S",  
   "assetId":"nb:cid:UUID:01234567-ABCD-ABCD-EFEF-01234567"  
}  
  

Si es correcto, se devuelve un código de estado 202 Accepted.

Ocultar pizarra

Puede señalar al codificador en directo que finalice una careta en curso mediante una solicitud HTTP POST.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate HTTP/1.1

Esta llamada solo debería invocarse cuando hay una careta en curso.

Para obtener más información, vea Información general de los canales habilitados para la codificación en directo.

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/HideSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Eliminar canales

Elimina un canal.

Método URI de solicitud Versión HTTP
Delete <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid') HTTP/1.1

Solicitud de ejemplo

Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

Encabezados de solicitud:

DELETE https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
  

Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un canal. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.

Consulte también

Entrega de transmisión en directo con Azure Media Services
Program