Canal

Artigo
07/19/2023

Nos Serviços de Multimédia do Azure (AMS), a entidade Canal representa um pipeline para o processamento de conteúdos de transmissão em fluxo em direto. Um Canal recebe transmissões de entrada em direto de uma de duas formas:

Um codificador em direto no local envia velocidade de transmissão RTMP múltipla ou Smooth Streaming (MP4 Fragmentado) para o Canal. Pode utilizar os seguintes codificadores em direto que transmitem Smooth Streaming com velocidade de transmissão múltipla: MediaExcel, Imagine Communications, Ateme, Envivio, Cisco e Elemental. Os seguintes codificadores em direto transmitem RTMP: codificadores Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek e Tricaster. Os fluxos ingeridos passam pelos Canais sem qualquer processamento adicional. Quando solicitado, os Media Services disponibilizam a transmissão em fluxo para os clientes.
Um único fluxo de velocidade de transmissão (num dos seguintes formatos: RTP (MPEG-TS), RTMPou Smooth Streaming (MP4 Fragmentado)) é enviado para o Channel que está ativado para executar a codificação em direto com os Serviços de Multimédia. Em Channel seguida, executa a codificação em direto da transmissão em fluxo de velocidade de transmissão única de entrada para uma transmissão em fluxo de vídeo com velocidade de transmissão múltipla (adaptável). Quando solicitado, os Media Services disponibilizam a transmissão em fluxo para os clientes.

A partir da versão dos Serviços de Multimédia 2.10, quando cria um Canal, pode especificar de que forma pretende que o seu canal receba o fluxo de entrada e se pretende ou não que o canal execute a codificação em direto da sua transmissão em fluxo. Tem duas opções:

None – Especifique este valor, se planear utilizar um codificador em direto no local que irá produzir uma transmissão em fluxo com velocidade de transmissão múltipla. Neste caso, o fluxo de entrada passou para a saída sem qualquer codificação. Este é o comportamento de um Canal antes da versão 2.10. Para obter informações mais detalhadas sobre como trabalhar com canais deste tipo, veja Working with Channels that Receive Multi-bitrate Live Stream from On-premises Encoders (Trabalhar com Canais que Recebem Transmissão em Direto de Velocidades Múltiplas a partir de Codificadores no local).
Standard – Se planear utilizar os Serviços de Multimédia para codificar a sua transmissão em fluxo em direto de velocidade de transmissão única para transmissão em fluxo com velocidade de transmissão múltipla, selecione este valor.

Nota

Tenha em atenção que existe um impacto na faturação da codificação em direto e deve lembrar-se de que deixar um canal de codificação em direto no estado "Em execução" irá incorrer em custos de faturação. Recomenda-se que pare imediatamente os seus canais de execução após a conclusão do evento de transmissão em fluxo em direto para evitar custos adicionais por hora. Para obter mais informações, consulte Trabalhar com Canais Ativados para Realizar Live Encoding com Media Services do Azure.

Para obter mais informações sobre a Transmissão em Fluxo em Direto e a gestão de canais, veja Entregar transmissão em fluxo em direto com os Serviços de Multimédia do Azure.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Este tópico fornece uma descrição geral da Channel entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Criar Canais
Iniciar Canais
Parar Canais
Canais de Lista
Repor Canais
Atualizar Canais
Iniciar Anúncio
Fim do Anúncio
Mostrar Ardósia
Ocultar Ardósia
Eliminar Canais

Entidade de Canal

A Channel entidade contém as seguintes propriedades.

Propriedade	Tipo	Description
`Id` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.String	O ID do Canal, atribuído após a criação. O formato é: nb:chid:UUID:<GUID>.
`Name`	Edm.String	O nome do Canal. 1. Tem de ser exclusivo na sua conta dos Serviços de Multimédia. 2. Comprimento máximo = 32 carateres. 3. Não é possível conter espaços. 4. Apenas hífenes e carateres alfanuméricos. 5. Não é possível começar ou terminar com um hífen.
`Created` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.DateTime	Um valor de data/hora UTC que indica a hora da criação.
`Description`	Edm.String	Descrição fornecida pelo utilizador. O comprimento máximo é de 256 carateres.
`LastModified` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.DateTime	A data e hora da última atualização para o canal.
`State` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.String	O estado atual do canal. Valores possíveis incluem: - Parado. Este é o estado inicial do Canal após a sua criação. Neste estado, as propriedades do Canal podem ser atualizadas, mas a transmissão em fluxo não é permitida. - A começar. O canal está a ser iniciado. Não são permitidas atualizações ou transmissões em fluxo durante este estado. Se ocorrer um erro, o Canal regressa ao estado Parado . - Em execução. O Canal é capaz de processar transmissões em direto. - A parar. O canal está a ser parado. Não são permitidas atualizações ou transmissões em fluxo durante este estado. - A eliminar. O Canal está a ser eliminado. Não são permitidas atualizações ou transmissões em fluxo durante este estado.
`Input`	ChannelInput ComplexType	Definições de entrada do canal (ingestão).
`Output`	ChannelOutput ComplexType	Definições de saída do canal.
`Preview`	ChannelPreview ComplexType	Definições de pré-visualização do canal.
`CrossSiteAccessPolicies`	CrossSiteAccessPolicies	Políticas de acesso entre sites.
`Programs` Só de leitura. Definido pelos Serviços de Multimédia.	Uma coleção de Programass.	Uma referência à coleção de programas associados ao canal.
`EncodingType`	Edm.String	`Optional`. Descreve a configuração do Canal. Os valores permitidos são: - `None` – Este é o valor predefinido. Quando seleciona este valor, o fluxo de entrada passou para a saída sem qualquer codificação (este é o comportamento de um Canal antes da versão 2.10). - `Standard` – O fluxo de velocidade de transmissão única recebido é enviado para o Canal e transcodificado para um fluxo de velocidade de transmissão múltipla com as predefinições do sistema
`Encoding`	Codificação ComplexType	Definições do codificador em direto do Azure.
`Slate`	Ardósia	Esta definição só é suportada quando o `Encoding Type` canal está definido como `Standard`. O codificador em direto no Canal pode ser sinalizado para mudar para uma imagem de ardósia. Também pode ser sinalizado para terminar uma ardósia em curso. O codificador dinâmico pode ser configurado para mudar para uma imagem de ardósia e mascarar o sinal de vídeo recebido em determinadas situações, por exemplo, durante uma quebra de anúncio. Se tal ardósia não estiver configurada, o vídeo de entrada não será mascarado durante essa quebra de anúncio.

ChannelInput ComplexType

Nome	Tipo	Description
`KeyFrameInterval`	Edm.Time	Este valor é ignorado se `EncoderType` estiver definido como `Standard`. Ao utilizar um codificador em direto no local para gerar fluxo de velocidade de transmissão múltipla, o intervalo de fotogramas de chave especifica a duração do GOP (conforme utilizado por esse codificador externo). Assim que este fluxo de entrada for recebido pelo Canal, pode entregar a sua transmissão em direto às aplicações de reprodução de cliente em qualquer um dos seguintes formatos: Transmissão em Fluxo Uniforme, DASH e HLS. Ao efetuar a transmissão em fluxo em direto, o HLS é sempre empacotado dinamicamente. Por predefinição, os Serviços de Multimédia calculam automaticamente a proporção de empacotamento do segmento HLS (fragmentos por segmento) com base no intervalo de fotogramas de chave, também conhecido como Grupo de Imagens – GOP, que é recebido do codificador dinâmico.
`StreamingProtocol` Só de leitura.	Edm.String	Depois de definir o tipo de codificador, pode definir um protocolo de ingestão. Se estiver `Encoder Type` definido como `None`, as opções válidas são: - MP4 Fragmentado com velocidade de transmissão múltipla (Transmissão em Fluxo Uniforme) - RTMP com velocidade de transmissão múltipla `Encoder Type` Quando está definido como `None`, é válido, mas indesejável, para que seja enviado um único RTMP de velocidade de transmissão ou transmissão em fluxo em direto de Transmissão em Fluxo Uniforme. O canal não faz qualquer processamento com o fluxo, pelo que será transmitido, mas as aplicações cliente obterão um único fluxo de velocidade de transmissão. Se estiver `Encoder Type` definido como `Standard`, as opções válidas são: 1. Mp4 Fragmentado de velocidade de transmissão única (Transmissão em Fluxo Uniforme) 2. RtMP de velocidade de transmissão única 3. RTP (MPEG-TS): MPEG-2 Transport Stream através de RTP.
`AccessControl`	ChannelInputAccessControl ComplexType	Definições de controlo de acesso de entrada de canais.
`Endpoints` Só de leitura.	ChannelEndpoint ComplexType	Pontos finais de entrada do canal. Um Canal fornece pontos finais de entrada (URLs de ingestão) que, em seguida, utiliza para ingerir a sua transmissão em direto. O canal recebe fluxos de entrada em direto e disponibiliza os fluxos de saída para transmissão em fluxo através de um ou mais pontos finais de transmissão em fluxo.

ChannelPreview ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, veja Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
`AccessControl`	ChannelPreviewAccessControl ComplexType	Definições de controlo de acesso de pré-visualização do canal.
`Endpoints` Só de leitura.	ChannelEndpoint ComplexType	Pontos finais de pré-visualização do canal.

ChannelInputAccessControl ComplexType

Nome	Tipo	Description
`IP`	IPAccessControl	Endereços IP que têm permissão para ligar a pontos finais de entrada de canal. Os endereços IP têm de estar num dos seguintes formatos: endereço IpV4 com 4 números, intervalo de endereços CIDR.

ChannelPreviewAccessControl ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, veja Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
`IP`	IPAccessControl	Endereços IP que têm permissão para ligar a pontos finais de entrada de canal. Os endereços IP têm de estar num dos seguintes formatos: endereço IpV4 com 4 números, intervalo de endereços CIDR

IPAccessControl

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, veja Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
Permitir	IPRange ComplexType	Endereços IP que têm permissão para ligar a pontos finais de entrada de canal. Nota: Definir este valor como nulo permite que todos os endereços de origem IP se liguem. Defini-lo como uma cadeia vazia ("") não permite que ninguém se ligue.

IPRange ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, veja Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
`Name`	Edm.String	Um nome amigável para este Intervalo de IP.
`Address`	Edm.String	O endereço IP base da representação da sub-rede (por exemplo: 192.168.0.1).
`SubnetPrefixLength`	Edm.Int32	O número de bits significativos para a máscara de sub-rede (por exemplo, no seguinte endereço IP 192.168.0.1/24, 24 representa o número de bits significativos).

ChannelEndpoint ComplexType

Nome	Tipo	Description
`Protocol`	Edm.String	O protocolo de ponto final de transmissão em fluxo do canal.
`Url`	Edm.String	O URL do ponto final de transmissão em fluxo do canal.

ChannelOutput ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, veja Descrição geral dos Canais que estão ativados para Codificação em Direto

Nome	Tipo	Description
`Hls`	ChannelOutputHls ComplexType	As definições específicas do HLS.

ChannelOutputHls ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, consulte Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
`FragmentsPerSegment`	Edm.Int16	A quantidade de fragmentos por HTTP Live Streaming segmento (HLS).

Codificar ComplexType

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, consulte Descrição geral dos Canais que estão ativados para Codificação em Direto.

Nome	Tipo	Description
`AdMarkerSource`	Edm.String	Pode especificar a origem dos sinais de marcadores de anúncios. O valor predefinido é `Api`, que indica que o codificador em direto no Canal deve ouvir um assíncrono `Ad Marker API`. A outra opção válida é `Scte35` (permitida apenas se o protocolo de transmissão em fluxo de ingestão estiver definido como `RTP (MPEG-TS).` Quando `Scte35` for especificado, o codificador analisará `SCTE-35` os sinais do fluxo RTP (MPEG-TS) de entrada.
`IgnoreCea708ClosedCaptions`	Edm.bool	`Optional`. Um sinalizador opcional que indica ao codificador em direto para ignorar quaisquer dados de legendas CEA 708 incorporados no vídeo recebido. Quando o sinalizador está definido como falso (predefinição), o codificador irá detetar e inserir novamente dados CEA 708 nos fluxos de vídeo de saída.
`VideoStream`	VideoStream	`Optional`. Descreve a transmissão de vídeo de entrada. Se este campo não for especificado, é utilizado o valor predefinido. Esta definição só é permitida se o protocolo de transmissão em fluxo de entrada estiver definido como RTP (MPEG-TS).
`AudioStreams`	AudioStreams	`Optional`. Descreve os fluxos de áudio de entrada. Se este campo não for especificado, aplicam-se os valores predefinidos especificados. Esta definição só é permitida se o protocolo de transmissão em fluxo de entrada estiver definido como RTP (MPEG-TS).
`SystemPreset`	Edm.String	Especifica a predefinição do codificador a ser utilizada para este Canal. Atualmente, o único valor permitido é `Default720p` (predefinição). Para obter mais detalhes, veja SystemPreset

SystemPreset

Default720p especifica para codificar o vídeo para as 6 camadas seguintes.

Velocidade de Transmissão	Width	Height	MaxFPS	Perfil	Nome do Fluxo de Saída
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

O áudio é codificado para AAC-LC estéreo a 64 kbps, taxa de amostragem de 44,1 kHz.

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, consulte Descrição geral dos Canais que estão ativados para Codificação em Direto.

VideoStream

Descreve a transmissão de vídeo de entrada. Se este campo não for especificado, é utilizado o valor predefinido. Esta definição só é permitida se o protocolo de transmissão em fluxo de entrada estiver definido como RTP (MPEG-TS).

Nome	Tipo	Description
`Index`	Edm.Int1	Um índice baseado em zero que especifica que fluxo de vídeo de entrada deve ser processado pelo codificador em direto no Canal. Esta definição aplica-se apenas se o protocolo de transmissão em fluxo de ingestão for RTP (MPEG-TS). O valor predefinido é zero. Recomenda-se o envio de um único fluxo de transporte de programas (SPTS). Se o fluxo de entrada contiver vários programas, o codificador dinâmico analisa a Tabela de Mapa do Programa (PMT) na entrada, identifica as entradas que têm um nome de tipo de fluxo de Vídeo MPEG-2 ou H.264 e organiza-as pela ordem especificada no PMT. Em seguida, o índice baseado em zero é utilizado para recolher a entrada n nessa disposição.
`Name`	Edm.String	`Optional`. Etiqueta descritiva para este fluxo de vídeo de entrada.

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, consulte Descrição geral dos Canais que estão ativados para Codificação em Direto.

AudioStreams

Descreve os fluxos de áudio de entrada. Se este campo não for especificado, aplicam-se os valores predefinidos especificados. Esta definição só é permitida se o protocolo de transmissão em fluxo de entrada estiver definido como RTP (MPEG-TS).

Nome	Tipo	Description
`Index`	Edm.Int16	Recomenda-se o envio de um único fluxo de transporte de programas (SPTS). Se o fluxo de entrada contiver vários programas, O codificador em direto no Canal analisa a Tabela de Mapa do Programa (PMT) na entrada, identifica as entradas que têm um nome de tipo de fluxo de MPEG-2 AAC ADTS ou AC-3 System-A ou AC-3 System-B ou MPEG-2 Private PES ou MPEG-1 Audio ou MPEG-2 Audio e dispõe-os pela ordem especificada no PMT. Em seguida, o índice baseado em zero é utilizado para recolher a entrada n nessa disposição.
`Name`	Edm.String	`Optional`. Etiqueta descritiva para este fluxo de áudio de entrada.
`Language`	Edm.String	`Optional`. O identificador de idioma do fluxo de áudio, em conformidade com a ISO 639-2, como o ENG. Se não estiver presente, a predefinição é UND (indefinido). Podem ser especificados até 8 conjuntos de fluxos de áudio se a entrada para o Canal for MPEG-2 TS através de RTP. No entanto, não pode haver duas entradas com o mesmo valor de Índice.

Podem existir até 8 conjuntos de {Índice, Nome, Idioma} especificados se a entrada para o codificador for MPEG-2 TS através de RTP. No entanto, não pode haver duas entradas com o mesmo valor de Índice. Se a entrada para o codificador for RTMP ou HTTP (Transmissão em Fluxo Uniforme), só pode existir um fluxo de áudio na entrada.

Ardósia

Esta definição só é suportada quando o Encoding Type canal do está definido como Standard.

O codificador em direto no Canal pode ser sinalizado para mudar para uma imagem de ardósia. Também pode ser sinalizado para acabar com uma ardósia em curso.

O codificador dinâmico pode ser configurado para mudar para uma imagem de ardósia e mascarar o sinal de vídeo recebido em determinadas situações , por exemplo, durante uma quebra de anúncio. Se tal ardósia não estiver configurada, o vídeo de entrada não será mascarado durante essa quebra de anúncio.

Nome	Tipo	Description
`InsertSlateOnAdMarker`	Edm.Bool	Quando definida como Verdadeiro, esta definição configura o codificador dinâmico para inserir uma imagem de ardósia durante uma quebra de anúncio. O valor predefinido é true.
`DefaultSlateAssetId`	Edm.String	`Optional`. Especifica o ID do Recurso dos Serviços de Multimédia que contém a imagem de ardósia. A predefinição é nula. Antes de criar o Canal, a imagem de ardósia, de resolução máxima de 1920x1080, no formato JPEG e, no máximo, 3 Mbytes de tamanho, deve ser carregada como um recurso dedicado (nenhum outro ficheiro deve estar neste recurso). O nome do ficheiro deve ter uma extensão *.jpg e este AssetFile deve ser marcado como o ficheiro principal desse recurso. Este Recurso não pode ser encriptado pelo armazenamento. Se o ID do Recurso de ardósia predefinido não for especificado e inserir ardósia no marcador de anúncios estiver definido como verdadeiro, será utilizada uma imagem predefinida dos Serviços de Multimédia do Azure para mascarar o fluxo de entrada.

Para obter informações mais detalhadas sobre este tipo e as respetivas propriedades, consulte Descrição geral dos Canais que estão ativados para Codificação em Direto.

Criar Canais

Os canais podem ser criados com um pedido HTTP POST e especificar valores de propriedade.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

Cabeçalhos de pedido:

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>

O corpo do pedido seguinte mostra como criar um canal que está ativado para codificação em direto.

{  
   "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":[]  
   }  
}

O corpo do pedido seguinte mostra como criar um canal na conta que não está ativado para codificação em direto.

{  
"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  
   }  
}

Se for bem-sucedido, é devolvido um código de estado 202 Aceite juntamente com uma representação da entidade criada no corpo da resposta.

O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).

Iniciar Canais

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Iniciar	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

Cabeçalhos de pedido:

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>

Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).

Parar Canais

Um canal só pode ser parado quando está no estado Em execução e todos os programas no canal foram parados.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

Cabeçalhos de pedido:

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>

Canais de Lista

Os canais podem ser obtidos com um pedido GET HTTP.

Método	URI do pedido	Versão HTTP
GET	Obter todos os Canais: <https:// accountname.restv2>.<location.media.azure.net/api/Channels> Obter um Canal especificado. <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Se for bem-sucedida, esta operação devolve um código de estado 200 OK e uma lista de todos os Canais criados na sua conta dos Serviços de Multimédia.

Repor Canais

Repõe o estado do Canal do runtime mantido durante a transmissão em fluxo de uma apresentação em direto e permite a reutilização de um Canal em caso de reposições de apresentação ou reconfiguração do codificador. Pare todos os Programas antes de chamar Repor. A reposição pode ser chamada num Canal que esteja no estado em execução.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.

Atualizar Canais

Atualizações propriedades num Canal existente. O Canal tem de estar no estado Parado .

Método	URI do pedido	Versão HTTP
PATCH/PUT/MERGE Para obter mais informações sobre estas operações, consulte PATCH/PUT/MERGE.	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Corpo do pedido:

"Encoding":{"IgnoreCea708ClosedCaptions": true}

Se a atualização for concluída de forma síncrona, devolve um código de estado 204 Sem Conteúdo ; caso contrário, devolve um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.

Iniciar Anúncio

O codificador dinâmico pode ser sinalizado para iniciar um anúncio ou quebra comercial com um pedido POST HTTP e especificar valores de propriedade do na entidade Entidade StartAdvertisement no corpo do pedido.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement	HTTP/1.1

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

Entidade StartAdvertisement

Esta entidade representa a API de início de anúncio – é uma chamada assíncrona ao codificador em direto para inserir um anúncio ou quebras comerciais no fluxo de saída.

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

Nome	Tipo	Description
`duration`	Edm.Duration	A duração, em segundos, da quebra comercial. Tem de ser um valor positivo não zero para iniciar a quebra comercial. Quando uma interrupção comercial está em curso e a duração está definida como zero com o CueId que corresponde à quebra comercial em curso, essa quebra é cancelada.
`cueId`	Edm.Int	ID exclusivo para a quebra comercial, a ser utilizado pela aplicação a jusante para tomar as ações adequadas. Tem de ser um número inteiro positivo.
`showSlate`	Edm.Bool	`Optional`. Indica ao codificador em direto no Canal que tem de mudar para a imagem de ardósia predefinida durante a pausa comercial (e mascarar o feed de vídeo recebido). A predefinição é falso. A imagem utilizada será a especificada através da propriedade de ID de recurso de ardósia predefinida no momento da criação do canal.

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Corpo

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

Se for bem-sucedido, é devolvido um código de estado 202 Aceite .

Fim do Anúncio

O codificador em direto pode ser sinalizado para terminar um anúncio em curso ou uma quebra comercial através de um pedido POST HTTP.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement	HTTP/1.1

Esta chamada só deve ser invocada quando existe um anúncio em curso.

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Se for bem-sucedido, é devolvido um código de estado 202 Aceite .

Mostrar Ardósia

Indica ao codificador em direto no Canal que tem de mudar para a imagem de ardósia predefinida durante a pausa comercial (e mascarar o feed de vídeo recebido). A predefinição é falso. A imagem utilizada será a especificada através da propriedade de ID de recurso de ardósia predefinida no momento da criação do canal.

Utilize as propriedades da Entidade ShowSlate no corpo do pedido HTTP.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate	HTTP/1.1

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

ShowSlate Entity

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

Nome	Tipo	Description
`duration`	Edm.Duration	A duração, em segundos, da ardósia. Tem de ser um valor positivo não zero para iniciar a ardósia. Se existir uma ardósia em curso e a duração de zero for especificada, essa ardósia em curso será terminada.
`assetId`	Edm.String	Especifica o ID do Recurso dos Serviços de Multimédia que contém a imagem de ardósia. Antes de criar o Canal, a imagem de ardósia, de resolução 1920x1080, no formato JPEG e, no máximo, 3 Mbytes de tamanho, deve ser carregada como um Recurso dedicado (nenhum outro ficheiro deve estar neste Recurso). O codificador pode ser sinalizado para mudar para qualquer imagem de ardósia arbitrária (e não apenas a especificada através da propriedade DefaultSlateAssetId no momento da criação do Canal).

Se a DefaultSlateAssetId propriedade for especificada e AssetId não for especificada, a DefaultSlateAssetId imagem será utilizada para mascarar o fluxo de entrada. Para obter mais informações, consulte Ardósia.

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Corpo

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

Se for bem-sucedido, é devolvido um código de estado 202 Aceite .

Ocultar Ardósia

O codificador em direto pode ser sinalizado para terminar uma ardósia em curso com um pedido POST HTTP.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate	HTTP/1.1

Esta chamada só deve ser invocada quando existe uma lista em curso.

Para obter mais informações, veja Descrição geral dos Canais que estão ativados para Codificação Em Direto.

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.

Eliminar Canais

Eliminar um canal.

Método	URI do pedido	Versão HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Cabeçalhos de pedido:

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>

Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um Canal. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.

Consulte também

Fornecer transmissão em fluxo em direto com os Serviços de Multimédia do Azure
Programa

Partilhar via

Canal

Entidade de Canal

ChannelInput ComplexType

ChannelPreview ComplexType

ChannelInputAccessControl ComplexType

ChannelPreviewAccessControl ComplexType

IPAccessControl

IPRange ComplexType

ChannelEndpoint ComplexType

ChannelOutput ComplexType

ChannelOutputHls ComplexType

Codificar ComplexType

SystemPreset

VideoStream

AudioStreams

Ardósia

Criar Canais

Pedido de Amostra

Iniciar Canais

Pedido de Amostra

Parar Canais

Pedido de Amostra

Canais de Lista

Pedido de Amostra

Repor Canais

Pedido de Amostra

Atualizar Canais

Pedido de Amostra

Iniciar Anúncio

Entidade StartAdvertisement

Pedido de Amostra

Fim do Anúncio

Pedido de Amostra

Mostrar Ardósia

ShowSlate Entity

Pedido de Amostra

Ocultar Ardósia

Pedido de Amostra

Eliminar Canais

Pedido de Amostra

Consulte também

Recursos adicionais