Canal

Artículo
07/19/2023

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:

None: especifique este valor si piensa utilizar un codificador en directo local que generará la secuencia de velocidad de bits múltiple. En este caso, el flujo entrante pasa hasta la salida sin codificación alguna. Este es el comportamiento de un canal antes de la versión 2.10. Para obtener información más detallada sobre cómo trabajar con canales de este tipo, consulte Working with Channels that Receive Multi-bitrate Live Stream from On-premises Encoders (Trabajar con canales que reciben streaming en directo de velocidad de bits múltiple desde codificadores locales).
Standard – Si tiene previsto usar Media Services para codificar la secuencia en vivo de velocidad de bits única a una secuencia de velocidad de bits múltiple, elija este valor.

Nota

Tenga en cuenta que hay un impacto en la facturación para la codificación en directo y debe recordar que salir de un canal de codificación en directo en el estado "En ejecución" supondrá un coste adicional de facturación. Se recomienda detener inmediatamente sus canales de ejecución después que se complete su evento de transmisión en directo para evitar cargos por hora adicionales. Para obtener más información, consulte Uso de canales habilitados para Live Encoding con Azure Media Services.

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.

Crear canales
Iniciar canales
Detener canales
Enumerar canales
Restablecer canales
Canales de actualización
Iniciar anuncio
Fin del anuncio
Mostrar pizarra
Ocultar pizarra
Eliminar canales

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 `Standard`en . 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 `None`en `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 `None`en , 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 `Standard`en `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>

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>

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>

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>

Consulte también

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

Compartir a través de

Canal

Entidad Canal

ChannelInput ComplexType

ChannelPreview ComplexType

ChannelInputAccessControl ComplexType

ChannelPreviewAccessControl ComplexType

IPAccessControl

IPRange ComplexType

ChannelEndpoint ComplexType

ChannelOutput ComplexType

ChannelOutputHls ComplexType

Codificación complexType

SystemPreset

VideoStream

AudioStreams

Claqueta

Crear canales

Solicitud de ejemplo

Iniciar canales

Solicitud de ejemplo

Detener canales

Solicitud de ejemplo

Enumerar canales

Solicitud de ejemplo

Restablecer canales

Solicitud de ejemplo

Actualizar canales

Solicitud de ejemplo

Iniciar anuncio

Entidad StartAdvertisement

Solicitud de ejemplo

Finalizar anuncio

Solicitud de ejemplo

Mostrar pizarra

Entidad ShowSlate

Solicitud de ejemplo

Ocultar pizarra

Solicitud de ejemplo

Eliminar canales

Solicitud de ejemplo

Consulte también

Recursos adicionales