Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Callbacks do estúdio de produção

Última atualização: Jun 30, 2026

Os callbacks do estúdio de produção enviam notificações de eventos sobre operações, erros de tempo de execução e progresso da reprodução. Este tópico aborda os parâmetros de solicitação, códigos de status e exemplos de callback.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Descrição
CasterId String Não ID do estúdio de produção.
  • Obrigatório se EventType for OperateCallback ou RuntimeErrorCallback.
  • Opcional se EventType for EpisodeGroupCallback.
EventType String Sim Tipo do evento.
  • OperateCallback: callback de operações.
  • RuntimeErrorCallback: callback de erros de tempo de execução.
  • EpisodeGroupCallback: callback de reprodução em carrossel.
  • ShowListDTSCallback: callback de progresso da reprodução do episódio atual quando o estúdio de produção está no modo lista de reprodução.
EventMessage EventMessage Sim Detalhes do evento. Para mais informações, consulte a seção EventMessage deste tópico.

EventMessage

  • Campos de EventMessage quando EventType é OperateCallback ou RuntimeErrorCallback:

    Campo

    Tipo

    Obrigatório

    Descrição

    RequestId

    String

    Não

    ID da solicitação. Obrigatório se EventType for OperateCallback.

    SceneId

    String

    Não

    ID da cena. Necessário para eventos de cena.

    LayoutId

    String

    Não

    ID do layout. Necessário para eventos de layout.

    ResourceId

    String

    Não

    ID do recurso. Necessário para eventos de source de vídeo.

    ComponentId

    String

    Não

    ID do componente. Necessário para eventos de componente.

    Code

    String

    Não

    Código de status.

    Message

    String

    Não

    Mensagem do evento.

  • Campos de EventMessage quando EventType é EpisodeGroupCallback:

    Campo

    Tipo

    Obrigatório

    Descrição

    ProgramId

    String

    Sim

    ID da lista de episódios para reprodução em carrossel.

    EpisodeId

    String

    Sim

    ID do episódio.

    Code

    String

    Não

    Código de status.

    Message

    String

    Não

    Mensagem do evento.

  • Campos de EventMessage quando EventType é ShowListDTSCallback:

    Campo

    Tipo

    Obrigatório

    Descrição

    ProgressTime

    String

    Sim

    Progresso da reprodução do episódio. Unidade: milissegundos.

    ShowId

    String

    Sim

    ID do episódio.

    Duration

    String

    Sim

    Duração total do episódio.

    ShowName

    String

    Sim

    Nome do episódio.

Códigos de status

Código de status

Descrição

Success

Operação concluída com êxito.

StreamInterrupt

Reprodução de streams ao vivo ou arquivos encerrada inesperadamente.

CanvasStreamInterrupt

Stream do canvas encerrado inesperadamente.

AudioResampleFailed

Falha na reamostragem de áudio.

AudioAddFailed

Falha ao adicionar a source de áudio.

AudioDelFailed

Falha ao excluir a source de áudio.

AudioStreamTypeInvalid

Falha ao analisar o tipo de stream de áudio.

VideoTypeInvalid

Falha ao analisar o tipo da camada.

VideoVisibleInvalid

Falha ao analisar a visibilidade do elemento da camada.

VideoTransparencyInvalid

Falha ao analisar o valor de transparência do elemento da camada.

VideoEffectInvalid

Falha ao analisar o valor de efeito do elemento da camada.

VideoWidthInvalid

Falha ao analisar o valor normalizado da largura do elemento da camada.

VideoPositionReferInvalid

Falha ao analisar o eixo de referência do elemento da camada.

VideoStreamTypeInvalid

Falha ao analisar o tipo de mídia. Tipos de mídia incluem streams ao vivo e arquivos.

VideoRepeatNumInvalid

Falha ao analisar a contagem de repetições do arquivo de vídeo sob demanda (VOD).

VideoStreamAddFailed

Falha ao adicionar o stream ao vivo.

ImageOpenFailed

Falha ao abrir a imagem.

ImageGetDecodeInfoFailed

Falha ao consultar as informações de decodificação da imagem.

ImageDecodeFailed

Falha ao decodificar a imagem.

TextInvalid

Falha ao analisar o texto.

TextFontInvalid

Falha ao analisar a fonte do texto.

TextSizeInvalid

Falha ao analisar o valor normalizado do tamanho da fonte do texto.

TextBorderWidthInvalid

Falha ao analisar o valor normalizado da largura da borda do texto.

CanvasLoadFailed

Falha ao carregar o stream do canvas.

SideOutputUrlInvalid

URL de redirecionamento do stream inválida.

Exemplos

Callback de operações

 {
    "CasterId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
    "EventType": "OperateCallback",
    "EventMessage": {
        "RequestId": "26A96B9A-A201-4EC3-8E43-CB92E68FA132",
        "SceneId": "35716B9A-A201-4EC3-8E43-CB92E68F****",
        "ComponentId": "06196B9A-A201-4EC3-8E43-CB92E68F****",
        "Code": "ImageOpenFailed",
        "Message": "Fail to open image: http://XXXX/XXXX.jpg"
    }
}

Callback de erros de tempo de execução

{
    "CasterId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
    "EventType": "RuntimeErrorCallback",
    "EventMessage": {
      "Code": "StreamInterrupt",
      "Message": "Failed to open stream: rtmp://DOMAIN/APP/STREAM"
    }
}

Callback de progresso da reprodução

{
  "EventMessage": {
    "ProgressTime": "116796",
    "ShowId": "9ef1db9d-5e24-4e5f-b161-8a2429d9b882",
    "Duration": "396847",
    "ShowName": "test.mp4"
  },
  "EventType": "ShowListDTSCallback",
  "ResponseTime": 1663731128684,
  "CasterId": "3761c920-dfa6-40c7-a79c-2886b1493996"
}