Todos os produtos
Search

Este produto

    Intelligent Media Management:**Exemplo: Processar mensagens de tarefas assíncronas com SMQ**

    Central de documentação

    Intelligent Media Management:**Exemplo: Processar mensagens de tarefas assíncronas com SMQ**

    Última atualização: Jun 27, 2026

    Este tópico descreve como usar o Simple Message Queue (SMQ) para receber notificações de status de tarefas assíncronas do Intelligent Media Management (IMM).

    Criar recursos do Simple Message Queue (SMQ)

    Etapa 1: Criar um tópico SMQ

    1. Faça login no console de gerenciamento do Simple Message Queue (SMQ).

    2. No painel de navegação à esquerda, selecione Topic List e clique em Create Topic.

    3. No painel Create Topic, crie um tópico chamado tf-test-mns-topic.

      Defina maximum message length como 65536 e Enable Logging como No.

    4. Clique em OK.

    Etapa 2: Criar uma fila SMQ

    1. Faça login no console de gerenciamento do Simple Message Queue (SMQ).

    2. No painel de navegação à esquerda, selecione Queue List e clique em Create Queue.

    3. No painel Create Queue, crie uma fila chamada tf-test-mns-queue.

      Configure os parâmetros da fila conforme a seguir: defina maximum message length como 64 KB, long polling time como 0 segundos (para desativar o long polling), visibility timeout como 30 segundos, message retention period como 4 dias e message delay como 0 segundos. Mantenha Enable Logging desativado.

    4. Clique em OK.

    Etapa 3: Associar o tópico e a fila SMQ

    1. Faça login no console de gerenciamento do Simple Message Queue (SMQ).

    2. No painel de navegação à esquerda, selecione Topic List e clique no tópico criado na Etapa 1: Criar um tópico SMQ (tf-test-mns-topic).

    3. Selecione a aba Subscription List e clique em Create Subscription.

    4. No painel Create Subscription, crie uma assinatura chamada tf-test-mns-subscription com as seguintes configurações:

      • Subscription Type: Selecione Queue.

      • Receiver Endpoint: Selecione tf-test-mns-queue, a fila criada na Etapa 2: Criar uma fila SMQ.

      • Message Format: Selecione JSON.

    5. Clique em OK.

    Opcional: Criar recursos do Object Storage Service (OSS)

    Nota

    Se você já tiver os recursos necessários no Object Storage Service (OSS), ignore esta seção e prossiga para Iniciar uma chamada ao IMM.

    Etapa 1: Criar um bucket

    1. Faça login no console de gerenciamento do Object Storage Service (OSS).

    2. No painel de navegação à esquerda, selecione Buckets e clique em Create Bucket.

    3. No painel Create Bucket, crie um bucket chamado tf-test-oss-bucket.

    Etapa 2: Fazer upload de um arquivo

    1. Faça login no console de gerenciamento do Object Storage Service (OSS).

    2. No painel de navegação à esquerda, selecione Buckets e clique em tf-test-oss-bucket, o bucket criado na Etapa 1: Criar um bucket.

    3. Clique em Upload Object e siga as instruções na tela para fazer upload do arquivo 1.docx.

    Iniciar uma chamada ao IMM

    Etapa 1: Criar um projeto

    1. Faça login no console de gerenciamento do Intelligent Media Management (IMM).

    2. No painel de navegação à esquerda, selecione Project List e clique em Create Project.

    3. No painel Create Project, crie um projeto chamado tf-test-imm-project e defina a service-linked role como AliyunIMMDefaultRole.

      Importante

      Se utilizar uma função de serviço personalizada, consulte Configurar uma função de serviço para um projeto para definir as permissões.

    4. Clique em OK.

    Etapa 2: Iniciar uma chamada ao IMM

    1. Acesse o OpenAPI Explorer.

    2. Na lista de APIs à esquerda, escolha Document Processing > CreateOfficeConversionTask.

    3. Insira os seguintes valores de parâmetro:

      • ProjectName: Insira tf-test-imm-project, o projeto criado na Etapa 1: Criar um projeto.

      • SourceURI: Insira oss://tf-test-oss-bucket/1.docx, o caminho do arquivo source enviado na Etapa 2: Fazer upload de um arquivo ou outro documento no bucket.

      • TargetURIPrefix: Insira oss://tf-test-oss-bucket/output, o prefixo do caminho de armazenamento do arquivo de saída convertido.

      • TargetType: Insira png, o tipo de arquivo da saída convertida.

      • TopicName: Insira tf-test-mns-topic, o tópico SMQ criado na Etapa 1: Criar um tópico SMQ.

    4. Clique em Initiate Call.

    Receber mensagens SMQ

    1. Faça login no console de gerenciamento do Simple Message Queue (SMQ).

    2. No painel de navegação à esquerda, selecione Queue List e clique em tf-test-mns-queue, a fila criada na Etapa 2: Criar uma fila SMQ.

    3. No canto superior direito da página Queue Details, clique em Send and Receive Messages.

    4. Na página Send and Receive Messages, clique em Receive Message. Uma nova mensagem aparecerá na página.

      O registro da mensagem recebida inclui as colunas Message ID, Consume Count, First Consume Time, Message Creation Time e Actions (Details, Delete).

    5. Na coluna Actions da mensagem, clique em Details para visualizar os detalhes.

      A caixa de diálogo de detalhes da mensagem contém informações básicas (message ID, Consume Count, First Consume Time, Message Creation Time, Next Visible Time e message handle) e uma área de Original Message Content. O tipo da mensagem é imm:Task:OfficeConversion e a origem é acs.imm, o que indica que a tarefa de conversão de documentos do IMM foi acionada com sucesso. A caixa de diálogo também exibe o Base64-decoded message content e o Message MD5 Content.

    Perguntas frequentes

    Não é possível receber mensagens SMQ

    Se não estiver recebendo mensagens SMQ, verifique os seguintes pontos:

    • Verifique se o tópico SMQ e o projeto IMM estão na mesma região.

    • Confirme se a fila SMQ está inscrita no tópico e se o message format da assinatura está definido como JSON.

    • Verifique se há múltiplos consumidores processando mensagens da fila simultaneamente.

    • Valide se a função de serviço do projeto IMM tem permissão para enviar mensagens ao SMQ. Para mais detalhes, consulte Configurar uma função de serviço para um projeto.