Todos os produtos
Search

Este produto

    ApsaraVideo Live:AddLiveStreamMerge

    Central de documentação

    ApsaraVideo Live:AddLiveStreamMerge

    Última atualização: Jun 28, 2026

    Chama AddLiveStreamMerge para adicionar uma configuração de mesclagem de fluxo principal/backup.

    Descrição da operação

    Exceder o limite da API de 100 QPS por conta aciona a limitação de taxa, o que pode interromper o seu serviço. Faça as chamadas de forma adequada.

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

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 Nenhuma 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
    DomainName

    string

    Sim

    O domínio de streaming.

    example.com
    AppName

    string

    Sim

    O AppName do fluxo de saída. Para que a configuração entre em vigor, este AppName deve corresponder ao da URL de ingestão. Curingas (*) não são suportados.

    app
    StreamName

    string

    Sim

    O StreamName do fluxo de saída. Para que a configuração entre em vigor, este StreamName deve corresponder ao da URL de ingestão. Curingas (*) não são suportados.

    StreamName
    InAppName1

    string

    Sim

    O AppName do fluxo de entrada principal. Este valor deve corresponder ao AppName na URL de ingestão do fluxo principal.

    app1
    InStreamName1

    string

    Sim

    O StreamName do fluxo de entrada principal. Este valor deve corresponder ao StreamName na URL de ingestão do fluxo principal.

    InStream1
    InAppName2

    string

    Sim

    O AppName do fluxo de entrada de backup. Este valor deve corresponder ao AppName na URL de ingestão do fluxo de backup.

    app2
    InStreamName2

    string

    Sim

    O StreamName do fluxo de entrada de backup. Este valor deve corresponder ao StreamName na URL de ingestão do fluxo de backup.

    stream2
    StartTime

    string

    Sim

    A hora de início da mesclagem de fluxo.

    A hora deve estar em UTC e especificada no formato padrão ISO 8601: yyyy-MM-ddTHH:mm:ssZ.

    2020-05-29T00:00:00Z
    EndTime

    string

    Sim

    A hora de término da mesclagem de fluxo.

    A hora deve estar em UTC e especificada no formato padrão ISO 8601: yyyy-MM-ddTHH:mm:ssZ.

    Nota

    O intervalo entre StartTime e EndTime não pode exceder 7 dias.

    2020-05-29T01:00:00Z
    Protocol

    string

    Não

    O protocolo de transmissão ao vivo para os fluxos de entrada. Valores válidos:

    • rtmp (Padrão)

    • rtc

    rtmp
    LiveMerger

    string

    Não

    O mecanismo a ser usado para a mesclagem de fluxos.

    • on: O novo mecanismo liveswitch.

    • off: Um mecanismo legado (como rtmpr). Este é o padrão.

    off
    MergeParameters

    string

    Não

    Parâmetros que definem as condições de failover. Um failover é acionado quando uma das seguintes condições é atendida:

    1. Ocorre uma desconexão explícita do fluxo, como um fim de arquivo (EOF) ou erro de rede.

    2. A taxa de travamentos excede 60% nos últimos 5 segundos.

    3. Ocorre um tempo limite de pull do fluxo se nenhum dado de quadro for recebido por 2 segundos consecutivos.

    4. A taxa média de quadros durante o período especificado por ali_max_no_frame_timeout cai abaixo de ali_low_frame_rate_threshold. Esta condição se aplica mesmo que não haja desconexão ou travamento do fluxo. Se você definir ali_max_no_frame_timeout, o tempo limite para a Condição 3 também será atualizado para este valor.

    5. Se block_all_jitter estiver definido como 1, as Condições 2, 3 e 4 não se aplicam.

    • ali_max_no_frame_timeout: um número inteiro de 2 a 10.
      ali_low_frame_rate_threshold: um número inteiro de 1 a 200.
      block_all_jitter: 0 ou 1.

    ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0
    SelectAppName

    string

    Não

    SelectStreamName

    string

    Não

    SwitchMode

    string

    Não

    Nota

    Os valores para AppName, InAppName1 e InAppName2 devem ser exclusivos. Da mesma forma, os valores para StreamName, InStreamName1 e InStreamName2 devem ser exclusivos.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID exclusivo da solicitação.

    16A96B9A-F203-4EC5-8E43-CB92E68F****
    Message

    string

    • Uma mensagem que indica o resultado da solicitação. Se a solicitação falhar, esta mensagem ajuda o chamador a identificar o problema.

    • Valores válidos: OK, config invalid, degrade to no livemerger.

    OK

    A mensagem "config invalid, degrade to no livemerger" significa que a configuração para o novo mecanismo liveswitch está incompleta, causando um downgrade automático para o mecanismo legado.

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
  "Message": "OK"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidStartTime.Malformed Specified parameter StartTime is not valid.
    400 InvalidEndTime.Malformed Specified parameter EndTime is not valid.
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. The value specified for the StartTime parameter is invalid.
    400 InvalidParam Parameter invalid. Illegal input parameters
    400 QuotaExceeded.Merge Exceed max merge count limit
    400 ConfigAlreadyExists Config has already exist.
    400 Duration.Exceed Duration between StartTime and EndTime is too long.
    400 InvalidParam.CodeIllegalDuration %s. The value of start time should be less than the value of end time .
    500 InternalError The request processing has failed due to backend service exception.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.