Tous les produits
Search

Ce produit

    ApsaraVideo VOD:Rappels Simple Message Queue (anciennement MNS)

    Centre de documentation

    ApsaraVideo VOD:Rappels Simple Message Queue (anciennement MNS)

    Dernière mise à jour :Aug 25, 2026

    Utilisez Simple Message Queue (formerly MNS) pour recevoir les notifications d'événements d'ApsaraVideo VOD.

    Informations générales

    Alibaba Cloud Simple Message Queue (formerly MNS) (SMQ) est un service de file d'attente de messages distribué efficace, fiable, sécurisé et évolutif. Simple Message Queue (formerly MNS) propose un modèle de file d'attente permettant à plusieurs producteurs et consommateurs d'accéder simultanément à la même file. Une fois qu'un message est récupéré, il devient indisponible pour les autres consommateurs pendant une période déterminée. Vous devez supprimer explicitement le message après sa consommation ; sinon, il pourra être consommé à nouveau. ApsaraVideo VOD prend en charge l'utilisation de Simple Message Queue (formerly MNS) pour envoyer des informations de rappel. Pour plus d'informations sur Simple Message Queue (formerly MNS), consultez la rubrique Présentation de Simple Message Queue (anciennement MNS).

    Mécanisme de rappel Simple Message Queue (anciennement MNS)

    1. Créez une file d'attente dans Simple Message Queue (formerly MNS) et configurez les rappels correspondants dans ApsaraVideo VOD.

    2. Lorsqu'un événement se produit, ApsaraVideo VOD écrit la notification d'événement dans la file d'attente Simple Message Queue (formerly MNS) de Simple Message Queue (formerly MNS).

    3. Un rappel est considéré comme réussi uniquement si ApsaraVideo VOD parvient à écrire le message dans Simple Message Queue (formerly MNS). Si l'opération d'écriture échoue en raison d'erreurs de configuration, telles que l'absence d'autorisation d'ApsaraVideo VOD pour accéder à Simple Message Queue (formerly MNS), un endpoint qui n'est pas public ou un nom de file d'attente incorrect, ApsaraVideo VOD tente d'envoyer le rappel jusqu'à trois fois. Si les trois tentatives échouent, le message est ignoré. Pour plus d'informations sur la validation des rappels et la logique de nouvelle tentative, consultez la rubrique Validation des rappels et nouvelles tentatives.

    4. Après un rappel réussi, récupérez les messages depuis Simple Message Queue (formerly MNS) pour afficher le contenu de la notification d'événement. Après avoir traité un message, supprimez-le explicitement afin d'éviter qu'il ne soit consommé à nouveau.

    Utilisation

    Prérequis

    Notes d'utilisation

    • ApsaraVideo VOD est disponible dans plusieurs régions. Les paramètres de notification d'événements sont indépendants pour chaque région ; vous pouvez donc configurer une méthode de rappel et une URL uniques pour chacune d'elles.

    • Dans Simple Message Queue (formerly MNS), vous pouvez créer plusieurs files d'attente Simple Message Queue (formerly MNS) dans différentes régions. Toutefois, dans ApsaraVideo VOD, vous ne pouvez configurer qu'une seule file d'attente Simple Message Queue (formerly MNS) pour les rappels MNS dans chaque région. Nous vous recommandons de créer et d'utiliser des files d'attente dans les régions suivantes :

      • Si vos vidéos sont stockées dans une région de Chine continentale, telle que Chine (Nord 2) ou Chine (Est 2), nous vous recommandons d'utiliser une file d'attente dans la région Chine (Shanghai). L'envoi de messages vers une file d'attente située en dehors de la région Chine (Shanghai) peut entraîner de légers retards.

      • Si vos vidéos sont stockées dans d'autres régions, telles que Singapour ou le Japon, nous vous recommandons de créer ou d'utiliser une file d'attente de messages dans la même région.

        Par exemple, si vos vidéos sont stockées dans la région Singapour, vous devez créer ou utiliser une file d'attente de messages dans la région Singapour.

    • Les rappels SMQ prennent en charge plusieurs URL de rappel pour différents environnements de développement. Pour plus d'informations, consultez la rubrique Configurer plusieurs URL de rappel.

    Procédure

    1. Autorisez ApsaraVideo VOD à accéder à Simple Message Queue (formerly MNS).

      Vous pouvez accorder l'autorisation de l'une des deux manières suivantes :

      • Méthode 1 : Accordez à ApsaraVideo VOD les autorisations nécessaires pour accéder à vos ressources cloud. Cela inclut des autorisations partielles pour OSS, Simple Message Queue (formerly MNS), CDN et KMS.

        Connectez-vous à la console Alibaba Cloud, accédez à la page Autorisation rapide RAM, puis cliquez sur Agree to Authorization pour accorder les autorisations.

      • Méthode 2 : Accordez à un utilisateur RAM, un groupe d'utilisateurs RAM ou un rôle RAM les autorisations requises pour accéder à Simple Message Queue (formerly MNS).

        Ajoutez la stratégie système AliyunMNSFullAccess (autorisations de gestion de Simple Message Queue (formerly MNS)) ou AliyunMNSReadOnlyAccess (autorisations de lecture seule pour Simple Message Queue (formerly MNS)) à votre politique d'autorisation. Pour obtenir des instructions détaillées, consultez la rubrique Créer un utilisateur RAM et lui accorder des autorisations.

    2. Créez une file d'attente dans Simple Message Queue (formerly MNS).

      Créez une nouvelle file d'attente ou utilisez-en une existante dans Simple Message Queue (formerly MNS). Vous pouvez créer une file d'attente via la console ou à l'aide d'une API/SDK. Pour les instructions relatives à la console, consultez la rubrique Créer une file d'attente. Pour plus d'informations sur les opérations d'API et les SDK associés, consultez la rubrique Opérations sur les files d'attente.

      Remarque

      Nous vous recommandons de créer ou d'utiliser une file d'attente dans la région suggérée dans la section Notes d'utilisation.

    3. Dans ApsaraVideo VOD, configurez les notifications d'événements pour utiliser la méthode de rappel Simple Message Queue (formerly MNS).

      Remarque

      Les paramètres de rappel configurés dans la console ApsaraVideo VOD s'appliquent globalement. Vous pouvez utiliser une OpenAPI pour configurer des rappels globaux ou implémenter une substitution pour une requête unique.

      Console

      1. Connectez-vous à la console ApsaraVideo VOD.

      2. Dans le volet de navigation de gauche, choisissez Configuration Management > Media Processing > Callback.

      3. Dans la barre de navigation supérieure, sélectionnez la région cible dans la liste déroulante située à côté de Workbench.

      4. Configurez le Callback.

        1. Dans la section Callback, cliquez sur Modify.

        2. Configurez les paramètres de rappel.

          Paramètre

          Description

          Méthode de rappel

          Sélectionnez Simple Message Queue (anciennement MNS).

          Région

          Sélectionnez la région où la vidéo est stockée. Nous vous recommandons de sélectionner la même région que celle de la file d'attente que vous avez créée dans Simple Message Queue (formerly MNS).

          File d'attente

          Sélectionnez une file d'attente dans la région spécifiée.

          Remarque

          Si aucune file d'attente n'est disponible, créez-en une au préalable. Pour plus d'informations, consultez la rubrique Créer une file d'attente.

          Événement de rappel

          Sélectionnez les types d'événements pour lesquels vous souhaitez recevoir des notifications. Pour plus d'informations sur les types d'événements pris en charge et leurs descriptions, consultez la rubrique Liste des événements.

          Remarque

          Si vous sélectionnez Video AI Processing Complete, les notifications sont déclenchées pour tous les événements d'IA, y compris AIMediaAuditComplete, AIMediaDNAComplete et AIVideoTagComplete.

        3. Cliquez sur OK pour enregistrer les paramètres de rappel Simple Message Queue (formerly MNS).

      API

      Appelez les opérations d'API pour configurer des rappels globaux ou effectuer une substitution pour une requête unique.

      Remarque

      Une substitution pour une requête unique en spécifiant le champ MessageCallback dans le paramètre UserData prend effet uniquement si vous avez activé les notifications d'événements globales dans ApsaraVideo VOD et configuré les types d'événements correspondants. Sinon, la substitution pour la requête unique ne prend pas effet.

    4. Déclenchez un événement de rappel.

      Après avoir configuré les notifications d'événements, effectuez des opérations dans ApsaraVideo VOD, telles que le téléchargement de fichiers multimédias ou le lancement de tâches de traitement multimédia, afin de déclencher des événements de rappel.

    5. Affichez les messages dans Simple Message Queue (formerly MNS).

      Lorsqu'un événement de rappel est déclenché, ApsaraVideo VOD écrit la notification d'événement dans la file d'attente que vous avez spécifiée. Récupérez les messages depuis Simple Message Queue (formerly MNS) et affichez le contenu de la notification dans les détails du message.

      Vous pouvez récupérer les messages via la console ou à l'aide d'une API/SDK. Pour les instructions relatives à la console, consultez la rubrique Recevoir des messages. Pour obtenir la liste des opérations d'API et des SDK associés, consultez la rubrique Présentation des opérations d'API liées aux files d'attente.

    6. Facultatif : Supprimez les messages dans Simple Message Queue (formerly MNS).

      Vous devez supprimer explicitement un message après sa consommation. Sinon, il redeviendra visible dans la file d'attente après une période déterminée et pourra être consommé à nouveau.

      Vous pouvez supprimer les messages via la console ou à l'aide d'une API/SDK. Pour les instructions relatives à la console, consultez la rubrique Opérations sur les files d'attente. Pour obtenir la liste des opérations d'API et des SDK associés, consultez la rubrique Présentation des opérations d'API liées aux files d'attente.

    Exemples de SDK

    Simple Message Queue (formerly MNS) fournit des SDK pour plusieurs langages de programmation. Après avoir configuré les rappels, utilisez le SDK correspondant pour consommer les messages :

    Documentation connexe