Définissez le paramètre UserData dans l'API ou le SDK d'ApsaraVideo VOD pour spécifier plusieurs URL de rappel HTTP ou Simple Message Queue (anciennement MNS). Cette fonctionnalité s'avère utile pour envoyer des notifications d'événements à plusieurs serveurs ou acheminer les messages de rappel vers différents environnements, tels que le développement, les tests et la production.
Description
ApsaraVideo VOD permet de configurer une seule méthode de rappel et une seule URL de rappel par région ; ce paramètre s'applique globalement. Pour spécifier plusieurs URL de rappel destinées à des services multi-environnements, utilisez le paramètre UserData.
Configurez les notifications d'événements globales
Limites
Pour utiliser les rappels Simple Message Queue (anciennement MNS), accédez à la page Autorisation rapide RAM afin d'autoriser ApsaraVideo VOD à accéder à Simple Message Queue (anciennement MNS).
Notes d'utilisation
ApsaraVideo VOD prend en charge les rappels HTTP et les rappels Simple Message Queue (anciennement MNS) pour les notifications d'événements globales. Vous ne pouvez configurer qu'une seule méthode de rappel et une seule URL de rappel par région. Lorsqu'un événement se produit, tel que le téléchargement de fichiers audio, vidéo ou image, ou la soumission de tâches de traitement multimédia comme le transcodage et la modération, ApsaraVideo VOD envoie des notifications d'événements selon les paramètres de rappel définis pour cette région.
Méthode de configuration
Configurez les notifications d'événements globales via la console ApsaraVideo VOD, le SDK ou l'API. Pour plus d'informations sur la procédure et les limites, consultez les rubriques Rappels HTTP et Rappels SMQ.
Spécifiez les URL de rappel dans UserData lors du téléchargement
Limites
Spécifiez le paramètre UserData uniquement via le SDK ou l'API d'ApsaraVideo VOD.
Activez la fonctionnalité de notification globale et spécifiez les événements pour lesquels vous souhaitez configurer des rappels. Sinon, les URL de rappel indiquées dans UserData ne prennent pas effet.
Notes d'utilisation
Spécifiez des URL de rappel dans UserData pour les fichiers multimédias téléchargés sur ApsaraVideo VOD à l'aide du SDK d'opération serveur ou du SDK de téléchargement. L'URL de rappel est associée au fichier source multimédia. Les notifications d'événements sont envoyées à cette URL lorsque vous soumettez des tâches de traitement multimédia, telles que les tâches de transcodage et de modération. Les paramètres de rappel globaux définissent les événements pour lesquels les rappels sont configurés. Si vous supprimez le fichier de ressource multimédia, les notifications d'événements suivantes sont envoyées à l'URL de rappel spécifiée dans les paramètres de rappel globaux.
Opérations connexes
Pour plus d'informations sur l'utilisation du SDK d'opération serveur ou du SDK de téléchargement, consultez les rubriques Notes d'utilisation et Vue d'ensemble.
Spécifiez le paramètre UserData lorsque vous appelez les opérations suivantes pour télécharger des fichiers multimédias :
Spécifiez les URL de rappel dans UserData lors du traitement multimédia
Limites
Spécifiez le paramètre UserData uniquement via le SDK ou l'API d'ApsaraVideo VOD.
Activez la fonctionnalité de notification globale et spécifiez les événements pour lesquels vous souhaitez configurer des rappels. Sinon, les URL de rappel indiquées dans UserData ne prennent pas effet.
Notes d'utilisation
Spécifiez des URL de rappel dans UserData lorsque vous soumettez des tâches de traitement multimédia, telles que des tâches de transcodage, via le SDK ou l'API d'ApsaraVideo VOD.
L'URL de rappel spécifiée dans UserData lors du traitement multimédia ne s'applique qu'à un seul événement. Si vous ne spécifiez pas d'URL de rappel lors du traitement multimédia, le système utilise en priorité les URL de rappel indiquées dans UserData lors du téléchargement, avant celles définies dans les paramètres de rappel globaux.
Opérations connexes
Spécifiez le paramètre UserData lorsque vous appelez les opérations suivantes pour soumettre des tâches de traitement multimédia :
Exemple de code
Pour plus d'informations sur la structure du paramètre UserData, consultez la section Paramètres de requête. L'exemple suivant illustre la structure de UserData :
{
"Extend":{
"width":1280,
"id":"028a8e56b*****1ebf6bb7afc74",
"height":720
},
"AccelerateConfig":{
"Type":"oss",
"Domain":"https://oss-accelerate.aliyuncs.com"
},
"MessageCallback":{
"CallbackURL":"https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/",
"CallbackType":"http"
}
}L'exemple suivant montre comment construire UserData :
public static String buildUserData() {
JSONObject userData = new JSONObject();
// Configure message callbacks.
JSONObject messageCallback = new JSONObject();
messageCallback.put("CallbackType", "http");
messageCallback.put("CallbackURL", "https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/");
userData.put("MessageCallback", messageCallback);
// The fields that you want to pass to UserData. You can pass custom parameters.
JSONObject extend = new JSONObject();
extend.put("id", "028a8e56b*****1ebf6bb7afc74");
extend.put("width", 1280);
extend.put("height", 720);
userData.put("Extend", extend);
// Configure upload acceleration if the acceleration service is needed. Before you can use upload acceleration, apply to enable the acceleration feature.
JSONObject accelerateConfig = new JSONObject();
accelerateConfig.put("Type", "oss");
accelerateConfig.put("Domain", "https://oss-accelerate.aliyuncs.com");
userData.put("AccelerateConfig", accelerateConfig);
return userData.toJSONString();
}