Todos los productos
Search

Este producto

    Intelligent Media Management:**Ejemplo: Procesar mensajes de tareas asíncronas con SMQ**

    Centro de documentos

    Intelligent Media Management:**Ejemplo: Procesar mensajes de tareas asíncronas con SMQ**

    Última actualización: Sep 04, 2026

    Este tema describe cómo utilizar Simple Message Queue (SMQ) para recibir notificaciones de estado de tareas asíncronas desde Intelligent Media Management (IMM).

    Crear recursos de Simple Message Queue (SMQ)

    Paso 1: Crear un tema de SMQ

    1. Inicie sesión en la consola de administración de Simple Message Queue (SMQ).

    2. En el panel de navegación izquierdo, seleccione Topic List y haga clic en Create Topic.

    3. En el panel Create Topic, cree un tema llamado tf-test-mns-topic.

      Establezca maximum message length en 65536 y configure Enable Logging como No.

    4. Haga clic en OK.

    Paso 2: Crear una cola de SMQ

    1. Inicie sesión en la consola de administración de Simple Message Queue (SMQ).

    2. En el panel de navegación izquierdo, seleccione Queue List y haga clic en Create Queue.

    3. En el panel Create Queue, cree una cola llamada tf-test-mns-queue.

      Configure los parámetros de la cola de la siguiente manera: establezca maximum message length en 64 KB, long polling time en 0 segundos (lo que deshabilita el sondeo largo), visibility timeout en 30 segundos, message retention period en 4 días y message delay en 0 segundos. Mantenga Enable Logging deshabilitado.

    4. Haga clic en OK.

    Paso 3: Asociar el tema y la cola de SMQ

    1. Inicie sesión en la consola de administración de Simple Message Queue (SMQ).

    2. En el panel de navegación izquierdo, seleccione Topic List y haga clic en el tema que creó en Step 1: Create an SMQ topic, es decir, tf-test-mns-topic.

    3. Seleccione la pestaña Subscription List y haga clic en Create Subscription.

    4. En el panel Create Subscription, cree una suscripción llamada tf-test-mns-subscription con la siguiente configuración:

      • Subscription Type: Seleccione Queue.

      • Receiver Endpoint: Seleccione tf-test-mns-queue, la cola que creó en Step 2: Create an SMQ queue.

      • Message Format: Seleccione JSON.

    5. Haga clic en OK.

    Opcional: Crear recursos de Object Storage Service (OSS)

    Nota

    Si ya cuenta con los recursos necesarios en Object Storage Service (OSS), puede omitir esta sección y continuar con initiate a call to IMM.

    Paso 1: Crear un bucket

    1. Inicie sesión en la consola de administración de Object Storage Service (OSS).

    2. En el panel de navegación izquierdo, seleccione Buckets y haga clic en Create Bucket.

    3. En el panel Create Bucket, cree un bucket llamado tf-test-oss-bucket.

    Paso 2: Cargar un archivo

    1. Inicie sesión en la consola de administración de Object Storage Service (OSS).

    2. En el panel de navegación izquierdo, seleccione Buckets y haga clic en tf-test-oss-bucket, el bucket que creó en Step 1: Create a bucket.

    3. Haga clic en Upload Object y siga las instrucciones en pantalla para cargar el archivo 1.docx.

    Iniciar una llamada a IMM

    Paso 1: Crear un proyecto

    1. Inicie sesión en la consola de administración de Intelligent Media Management (IMM).

    2. En el panel de navegación izquierdo, seleccione Project List y haga clic en Create Project.

    3. En el panel Create Project, cree un proyecto llamado tf-test-imm-project y establezca el service-linked role como AliyunIMMDefaultRole.

      Importante

      Si utiliza un rol de servicio personalizado, consulte Configure a service role for a project para obtener información sobre cómo configurar los permisos.

    4. Haga clic en OK.

    Paso 2: Iniciar una llamada a IMM

    1. Inicie sesión en OpenAPI Explorer.

    2. En la lista de API de la izquierda, elija Document Processing > CreateOfficeConversionTask.

    3. Introduzca los siguientes valores de parámetro:

      • ProjectName: Introduzca tf-test-imm-project, el proyecto que creó en Step 1: Create a project.

      • SourceURI: Introduzca oss://tf-test-oss-bucket/1.docx, la ruta del archivo de origen que cargó en Step 2: Upload a file o de otro documento en el bucket.

      • TargetURIPrefix: Introduzca oss://tf-test-oss-bucket/output, el prefijo de ruta de almacenamiento para el archivo de salida convertido.

      • TargetType: Introduzca png, el tipo de archivo de la salida convertida.

      • TopicName: Introduzca tf-test-mns-topic, el tema de SMQ que creó en Step 1: Create an SMQ topic.

    4. Haga clic en Initiate Call.

    Recibir mensajes de SMQ

    1. Inicie sesión en la consola de administración de Simple Message Queue (SMQ).

    2. En el panel de navegación izquierdo, seleccione Queue List y haga clic en tf-test-mns-queue, la cola que creó en Step 2: Create an SMQ queue.

    3. En la esquina superior derecha de la página Queue Details, haga clic en Send and Receive Messages.

    4. En la página Send and Receive Messages, haga clic en Receive Message. Aparecerá un nuevo mensaje en la página.

      El registro del mensaje recibido incluye las columnas Message ID, Consume Count, First Consume Time, Message Creation Time y Actions (Details, Delete).

    5. En la columna Actions del mensaje, haga clic en Details para ver los detalles del mensaje.

      El cuadro de diálogo de detalles del mensaje contiene información básica (message ID, Consume Count, First Consume Time, Message Creation Time, Next Visible Time y message handle) y un área de Original Message Content. El tipo de mensaje es imm:Task:OfficeConversion y el origen es acs.imm, lo que indica que la tarea de conversión de documentos de IMM se activó correctamente. El cuadro de diálogo también muestra el Base64-decoded message content y el Message MD5 Content.

    Preguntas frecuentes

    No se reciben mensajes de SMQ

    Si no puede recibir mensajes de SMQ, compruebe lo siguiente:

    • Verifique si el tema de SMQ y el proyecto de IMM se encuentran en la misma región.

    • Compruebe que la cola de SMQ esté suscrita al tema y que el message format de la suscripción esté configurado como JSON.

    • Verifique si hay varios consumidores procesando mensajes de la cola simultáneamente.

    • Compruebe si el rol de servicio del proyecto de IMM tiene permisos para enviar mensajes a SMQ. Para más detalles, consulte Configure a service role for a project.