DescribeLiveStreamTranscodeInfo - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Consulta as configurações de transcodificação.

Descrição da operação

Você deve obter o domínio de streaming antes de chamar esta operação para consultar as configurações de transcodificação.

Limite de QPS

Você pode chamar esta operação até 60 vezes por segundo por conta. Solicitações que excedam esse limite serão descartadas e você poderá sofrer interrupções no serviço.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:DescribeLiveStreamTranscodeInfo

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-shanghai
DomainTranscodeName	string	Sim	O domínio principal de streaming.	example.com
AppName	string	Não	O AppName da transmissão ao vivo.	myapp

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As configurações de transcodificação.
RequestId	string	O ID da solicitação.	62136AE6-7793-45ED-B14A-60D19A9486D3
DomainTranscodeList	object
DomainTranscodeInfo	array<object>	As configurações de transcodificação.
	array<object>	As configurações de transcodificação.
TranscodeApp	string	The AppName.	liveApp****
TranscodeTemplate	string	The transcoding template. Valid values: Standard transcoding templates: lld: low definition. lsd: standard definition. lhd: high definition. lud: ultra-high definition. Narrowband HD™ transcoding templates: ld: low definition. sd: standard definition. hd: high definition. ud: ultra-high definition.	lld
IsLazy	boolean	Indicates whether on-demand transcoding is enabled. Valid values: true: Transcoding only starts when the first viewer requests this transcoded stream. false: Transcoding starts immediately after the stream is published.	true
TranscodeName	string	The main streaming domain.	example.com
CustomTranscodeParameters	object	The custom transcoding configurations.
BitrateWithSource	object	The configuration for adaptive bitrate.	{\"UpLimit\":2500,\"LowerLimit\":800,\"Factor\":1}
VideoProfile	string	The video codec profile. Valid values: baseline: suitable for mobile devices. main: suitable for SD devices. high: suitable for HD devices.	high
AudioBitrate	integer	The audio bitrate. Unit: kbps. Valid values: 1 to 1000.	64
Height	integer	The output video height.	1200
RtsFlag	string	The tag for Real-Time Streaming (RTS). The value is fixed to true. Nota This parameter is returned only when RTS is used.	true
TemplateType	string	The type of the custom transcoding template. Valid values: h264: H.264 standard transcoding. h264-nbhd: H.264 Narrowband HD™ transcoding. h265: H.265 standard transcoding. h265-nbhd: H.265 Narrowband HD™ transcoding. audio: audio-only transcoding.	h264
Bframes	string	Controls whether to remove B-frames from the transcoded output video. The value is fixed to 0.	0
ExtWithSource	object	Other adaptive settings that align the transcoded stream with the source stream.	{\"KeyFrameOpen\":\"yes\",\"Copyts\":\"yes\",\"SeiMode\":1}
AudioRate	integer	The audio sample rate. Valid values: 22050 to 96000. Nota If AudioProfile is set to aac_ld, the sample rate cannot exceed 44100.	44100
FpsWithSource	object	Adapts the output frame rate based on the source's frame rate, while keeping it within a specified range.	{\"UpLimit\":60,\"LowerLimit\":1}
AudioCodec	string	The audio codec.	ACC
FPS	integer	The output video frame rate. Unit: frames per second (FPS).	15
Gop	string	The Group of Pictures (GOP) size. Unit: frames. Valid values: 1 to 3000.	10
Width	integer	The output video width.	1000
VideoBitrate	integer	The video bitrate. Unit: kbps.	3000
AudioChannelNum	integer	The number of audio channels. Valid values: 1: mono. 2: stereo.	2
AudioProfile	string	The audio codec profile. Valid values: aac_low aac_he aac_he_v2 aac_ld	aac_low
ResWithSource	object	The adaptive resolution settings.	{\"Type\":\"short\",\"Value\":\"1080\"}
DeInterlaced	boolean	Indicates whether to automatically detect and remove interlacing during transcoding. This converts interlaced content to progressive content. true: Deinterlacing is enabled. false: The source format is retained. No processing is performed. This is the default value.
EncryptParameters	object	The encryption configurations.
EncryptType	string	The encryption type. The value is fixed to aliyun.	aliyun
KmsKeyID	string	The ID of the customer master key (CMK) in Key Management Service (KMS).	afce5722-81d2-43c3-9930-7601da11****
KmsKeyExpireInterval	string	The key rotation period. Unit: seconds. Valid values: 60 to 3600.	3600

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "62136AE6-7793-45ED-B14A-60D19A9486D3",
  "DomainTranscodeList": {
    "DomainTranscodeInfo": [
      {
        "TranscodeApp": "liveApp****",
        "TranscodeTemplate": "lld",
        "IsLazy": true,
        "TranscodeName": "example.com",
        "CustomTranscodeParameters": {
          "BitrateWithSource": {
            "test": "test",
            "test2": 1
          },
          "VideoProfile": "high",
          "AudioBitrate": 64,
          "Height": 1200,
          "RtsFlag": "true",
          "TemplateType": "h264",
          "Bframes": "0",
          "ExtWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioRate": 44100,
          "FpsWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioCodec": "ACC",
          "FPS": 15,
          "Gop": "10",
          "Width": 1000,
          "VideoBitrate": 3000,
          "AudioChannelNum": 2,
          "AudioProfile": "aac_low",
          "ResWithSource": {
            "test": "test",
            "test2": 1
          },
          "DeInterlaced": false
        },
        "EncryptParameters": {
          "EncryptType": "aliyun",
          "KmsKeyID": "afce5722-81d2-43c3-9930-7601da11****",
          "KmsKeyExpireInterval": "3600"
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameters	%s Please check and try again later.	Exception parameter exists, please check and try again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.