Todos os produtos
Search

Este produto

    ApsaraVideo VOD:Callbacks do Simple Message Queue (formerly MNS)

    Central de documentação

    ApsaraVideo VOD:Callbacks do Simple Message Queue (formerly MNS)

    Última atualização: Jul 10, 2026

    Use o Simple Message Queue (formerly MNS) para receber notificações de eventos do ApsaraVideo VOD.

    Informações básicas

    O Alibaba Cloud Simple Message Queue (formerly MNS) (SMQ) é um service de fila de mensagens distribuído eficiente, confiável, seguro e escalável. O Simple Message Queue (formerly MNS) oferece um modelo de fila que permite a múltiplos produtores e consumidores acessarem simultaneamente a mesma fila. Após a recuperação, a mensagem fica indisponível para outros consumidores por um período específico. Exclua explicitamente a mensagem após o consumo; caso contrário, ela poderá ser consumida novamente. O ApsaraVideo VOD aceita o uso do Simple Message Queue (formerly MNS) para enviar informações de callback. Para obter mais detalhes sobre o Simple Message Queue (formerly MNS), consulte O que é o Simple Message Queue (formerly MNS)?.

    Mecanismo de callback do Simple Message Queue (formerly MNS)

    1. Crie uma fila no Simple Message Queue (formerly MNS) e configure os callbacks correspondentes no ApsaraVideo VOD.

    2. Quando um evento ocorre, o ApsaraVideo VOD grava a notificação de evento na fila do Simple Message Queue (formerly MNS).

    3. O callback só é considerado bem-sucedido se o ApsaraVideo VOD gravar a mensagem com êxito no Simple Message Queue (formerly MNS). Se a operação de gravação falhar devido a erros de configuração — como falta de autorização do ApsaraVideo VOD para acessar o Simple Message Queue (formerly MNS), endpoint não público ou nome de fila incorreto — o ApsaraVideo VOD tentará enviar o callback até três vezes. Se todas as tentativas falharem, a mensagem será descartada. Para mais detalhes sobre a lógica de validação e nova tentativa de callback, consulte Validação e novas tentativas de callback.

    4. Após um callback bem-sucedido, recupere as mensagens do Simple Message Queue (formerly MNS) para visualizar o conteúdo da notificação de evento. Depois de processar uma mensagem, exclua-a explicitamente para evitar que seja consumida novamente.

    Como usar

    Pré-requisitos

    Observações de uso

    • O ApsaraVideo VOD está disponível em várias regiões. As configurações de notificação de eventos são independentes para cada região, permitindo configurar um método de callback e uma URL exclusivos para cada uma delas.

    • No Simple Message Queue (formerly MNS), é possível criar múltiplas filas em diferentes regiões. No entanto, no ApsaraVideo VOD, você pode configurar apenas uma fila do Simple Message Queue (formerly MNS) para callbacks MNS em cada região. Recomendamos criar e usar filas nas seguintes regiões:

      • Se seus vídeos estiverem armazenados em uma região da china continental, como China (North 2) ou China (East 2), use uma fila na região China (Shanghai). O envio de mensagens para uma fila fora da região China (Shanghai) pode causar pequenos atrasos.

      • Caso seus vídeos estejam armazenados em outras regiões, como Singapore ou Japan, crie ou use uma fila de mensagens na mesma região.

        Por exemplo, se seus vídeos estiverem armazenados na região Singapore, crie ou use uma fila de mensagens na região Singapore.

    • Os callbacks SMQ aceitam múltiplas URLs de callback para diferentes ambientes de desenvolvimento. Para mais informações, consulte Configurar múltiplas URLs de callback.

    Procedimento

    1. Autorize o ApsaraVideo VOD a acessar o Simple Message Queue (formerly MNS).

      Conceda a autorização de uma das seguintes formas:

      • Método 1: Conceda ao ApsaraVideo VOD permissões para acessar seus recursos cloud. Isso inclui permissões parciais para OSS, Simple Message Queue (formerly MNS), CDN e KMS.

        Faça login no Alibaba Cloud console, acesse a página de RAM Quick Authorization e clique em Agree to Authorization para conceder as permissões.image

      • Método 2: Conceda a um usuário RAM, grupo de usuários RAM ou função RAM as permissões necessárias para acessar o Simple Message Queue (formerly MNS).

        Adicione a política de sistema AliyunMNSFullAccess (permissões para gerencie o Simple Message Queue (formerly MNS)) ou AliyunMNSReadOnlyAccess (permissões para gerencie o Simple Message Queue (formerly MNS)) à sua política de autorização. Para instruções detalhadas, consulte Criar um usuário RAM e conceder permissões.

    2. Crie uma fila no Simple Message Queue (formerly MNS).

      Crie uma nova fila ou use uma existente no Simple Message Queue (formerly MNS). É possível criar uma fila usando o console ou uma API/SDK. Para instruções via console, consulte Criar uma fila. Para informações sobre as operações de API e SDKs relacionados, consulte Operações de fila.

      Nota

      Recomendamos criar ou usar uma fila na região sugerida em Observações de uso.

    3. No ApsaraVideo VOD, configure as notificações de eventos para usar o método de callback do Simple Message Queue (formerly MNS).

      Nota

      As configurações de callback definidas no console do ApsaraVideo VOD aplicam-se globalmente. Use uma OpenAPI para configure callbacks globais ou implementar uma substituição para uma única solicitação.

      console

      1. Faça login no console do ApsaraVideo VOD.

      2. No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Callback.

      3. Na barra de navegação superior, selecione a região desejada na lista suspensa ao lado de Workbench.

      4. Configure o Callback.MNS回调1.png

        1. Na seção Callback, clique em Modify.

        2. Defina os parâmetros de callback.

          Parâmetro

          Descrição

          Método de callback

          Selecione Simple Message Queue (formerly MNS).

          Região

          Selecione a região onde o vídeo está armazenado. Recomendamos selecionar a mesma região da fila criada no Simple Message Queue (formerly MNS).

          Fila

          Escolha uma fila na região especificada.

          Nota

          Se não houver filas disponíveis, crie uma primeiro. Para mais informações, consulte Criar uma fila.

          Evento de callback

          Selecione os tipos de eventos para os quais deseja receber notificações. Para mais informações sobre os tipos de eventos compatíveis e suas descrições, consulte Lista de eventos.

          Nota

          Ao selecionar Video AI Processing Complete, as notificações serão acionadas para qualquer um dos eventos de IA, incluindo AIMediaAuditComplete, AIMediaDNAComplete e AIVideoTagComplete.

        3. Clique em OK para salve as configurações de callback do Simple Message Queue (formerly MNS).

      API

      Chame operações de API para configure callbacks globais ou realizar uma substituição para uma única solicitação.

      Nota

      A substituição para uma única solicitação, feita ao especificar o campo MessageCallback no parâmetro UserData, só terá efeito se você tiver habilitado as notificações globais de eventos no ApsaraVideo VOD e configurado os tipos de eventos correspondentes. Caso contrário, a substituição para a solicitação única não será aplicada.

    4. Acione um evento de callback.

      Após configure as notificações de eventos, execute operações no ApsaraVideo VOD, como fazer upload de arquivos de mídia ou iniciar jobs de processamento de mídia, para acionar eventos de callback.

    5. Visualize as mensagens no Simple Message Queue (formerly MNS).

      Quando um evento de callback é acionado, o ApsaraVideo VOD grava a notificação de evento na fila especificada. Recupere as mensagens do Simple Message Queue (formerly MNS) e visualize o conteúdo da notificação nos detalhes da mensagem.

      É possível recuperar mensagens usando o console ou uma API/SDK. Para instruções via console, consulte Receber mensagens. Para obter uma lista de operações de API e SDKs relacionados, consulte Visão geral das operações de API relacionadas a filas.

    6. Opcional: Exclua mensagens no Simple Message Queue (formerly MNS).

      Exclua explicitamente uma mensagem após o consumo. Caso contrário, ela ficará visível novamente na fila após um período específico e poderá ser consumida outra vez.

      Use o console ou uma API/SDK para excluir mensagens. Para instruções via console, consulte Operações de fila. Para obter uma lista de operações de API e SDKs relacionados, consulte Visão geral das operações de API relacionadas a filas.

    Exemplos de SDK

    O Simple Message Queue (formerly MNS) fornece SDKs para diversas linguagens de programação. Após configure os callbacks, use o SDK correspondente para consumir mensagens:

    Documentos relacionados