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

Inicia um estúdio de produção. Se as cenas PVW e PGM não existirem, elas serão criadas. As cenas PVW e PGM são iniciadas e as tarefas subjacentes de processamento de áudio e vídeo são acionadas.

Descrição da operação

Crie um estúdio de produção chamando a operação CreateCaster e, em seguida, chame esta operação para iniciar o estúdio de produção. Se as cenas PVW e PGM não existirem, elas serão criadas. As cenas PVW e PGM são iniciadas e as tarefas subjacentes de processamento de áudio e vídeo são acionadas.

Antes de chamar esta operação, chame SetCasterConfig para configurar DomainName. Se DomainName não estiver configurado, o erro InvalidDomainName.NotFound será retornado.

Limite de QPS

O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Chame esta operação conforme apropriado.

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:StartCaster

update

*Caster.

acs:live:*:{#accountId}:caster/{#CasterId}

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
CasterId	string	Sim	O ID do estúdio de produção. Se você criou o estúdio de produção chamando a operação CreateCaster, verifique o parâmetro CasterId na resposta de CreateCaster. Se você criou o estúdio de produção no console do ApsaraVideo Live, acesse Console do ApsaraVideo Live > Estúdios de Produção > Estúdio de Produção em Nuvem para visualizar o ID. Nota O nome do estúdio de produção na lista de estúdios de produção na página Estúdio de Produção em Nuvem é o ID do estúdio de produção.	80787064-1c94-4dc1-85ce-9409960a****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações do estúdio de produção.
PgmSceneInfos	object
SceneInfo	array<object>	A lista de informações da cena PGM.
	array<object>	A lista de informações da cena PGM.
SceneId	string	O ID do cenário.	b5f8c837-ceeb-424f-b30b-68e94e86****
StreamInfos	object
StreamInfo	array<object>	A lista de streams de saída de bypass.
	object	Um stream de saída de bypass.
OutputStreamUrl	string	A URL de reprodução.	rtmp://abclive/caster/example.net
TranscodeConfig	string	A configuração de transcodificação. Valores válidos: lsd: definição padrão. lld: baixa definição. lud: ultra-alta definição. lhd: alta definição.	lld
VideoFormat	string	O formato. Valores válidos: flv. rtmp. m3u8.	flv
StreamUrl	string	A URL do stream de reprodução para o cenário PGM do estúdio de produção. Esta não é a URL do stream de saída de bypass.	rtmp://abclive/caster/example.edu
PvwSceneInfos	object
SceneInfo	array<object>	A lista de informações da cena PVW.
	object	A lista de informações da cena PVW.
SceneId	string	O ID do cenário.	b5f8c837-ceeb-424f-b30b-68e94e86****
StreamUrl	string	A URL do stream de reprodução para o cenário PVW do estúdio de produção. Esta não é a URL do stream de saída de bypass.	rtmp://abclive/caster/example.net
RequestId	string	O ID da solicitação.	6EBD1AC4-C34D-4AE1-963E-B688A228BE31

Exemplos

Resposta de sucesso

JSON formato

{
  "PgmSceneInfos": {
    "SceneInfo": [
      {
        "SceneId": "b5f8c837-ceeb-424f-b30b-68e94e86****",
        "StreamInfos": {
          "StreamInfo": [
            {
              "OutputStreamUrl": "rtmp://abclive/caster/example.net",
              "TranscodeConfig": "lld",
              "VideoFormat": "flv"
            }
          ]
        },
        "StreamUrl": "rtmp://abclive/caster/example.edu"
      }
    ]
  },
  "PvwSceneInfos": {
    "SceneInfo": [
      {
        "SceneId": "b5f8c837-ceeb-424f-b30b-68e94e86****",
        "StreamUrl": "rtmp://abclive/caster/example.net"
      }
    ]
  },
  "RequestId": "6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidUserId.Malformed	%s, please check userId.	O userId especificado é inválido. Verifique o valor do parâmetro.
400	InvalidCasterId.Malformed	%s, please check and try again later.	O parâmetro CasterId é inválido. Verifique o parâmetro e tente novamente.
400	IncorrectSceneStatus	%s, please check and try again later.	O status da cena não é suportado. Verifique o status da cena e tente novamente.
400	IncorrectCasterStatus.Inuse	%s, please check and try again later.	O estúdio de produção já está ativado. Verifique a solicitação e tente novamente.
400	IncorrectSceneStatus.Inuse	%s, please check and try again later.	A cena já está ativada. Verifique o status da cena e tente novamente.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	O seguinte parâmetro é inválido: %s.
400	IncorrectChannel.Disable	%s, please check and try again later.	O canal está em um estado que não permite configuração. Verifique e tente novamente.
400	IncorrectCasterStatus.Cease	%s, please check and try again later.	O estúdio de produção foi suspenso devido a um pagamento em atraso. Quite o saldo devedor e tente novamente.
400	IncorrectCasterStatus.Expire	%s, please check and try again later.	A instância do estúdio de produção por assinatura expirou. Renove a instância e tente novamente.
401	IllegalOperation	%s, please check and try again later.	A operação é inválida. Verifique a solicitação e tente novamente.
403	UserQuotaExceed	Quota exceeded: %s.	A cota foi excedida: %s.
404	InvalidCaster.NotFound	%s, please check and try again later.	O estúdio de produção não existe. Verifique a configuração e tente novamente.
404	InvalidDomainName.NotFound	%s, please check and try again later.	O nome de domínio não existe. Verifique o nome de domínio e tente novamente.
404	InvalidCasterTemplate.NotFound	%s, please check and try again later.	O modelo de estúdio de produção não existe. Verifique e tente novamente.
404	InvalidConfiguration.NotFound	%s, please check and try again later.	A configuração não existe. Verifique a configuração e tente novamente.
404	InvalidResource.NotFound	%s, please check and try again later.	O recurso não existe. Verifique e tente novamente.
404	InvalidTranscode.NotFound	%s, please check and try again later.	A transcodificação não está configurada. Verifique a solicitação e tente novamente.
404	InvalidDelay.NotFound	%s, please check and try again later.	O atraso do stream não está configurado. Verifique a solicitação e tente novamente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.