ApsaraVideo VOD:Especifique múltiplas URLs de callback

Descrição

O ApsaraVideo VOD permite configurar apenas um método de callback e uma URL de callback por região. Essa configuração tem efeito global. Para especificar múltiplas URLs de callback para serviços multiambiente, use o parâmetro UserData.

Configure notificações globais de eventos

Limites

Para usar callbacks do Simple Message Queue (formerly MNS), acesse a página e autorize o ApsaraVideo VOD a acessar o Simple Message Queue (formerly MNS).

Observações de uso

O ApsaraVideo VOD oferece suporte a callbacks HTTP e do Simple Message Queue (formerly MNS) para notificações globais de eventos. Configure somente um método de callback e uma URL de callback para cada região. Ao acionar eventos como upload de arquivos de áudio, vídeo ou imagem, ou envio de jobs de processamento de mídia (como transcodificação e revisão), o ApsaraVideo VOD envia notificações com base nas configurações de callback da região.

Método de configuração

Configure as notificações globais de eventos pelo console, SDK ou API do ApsaraVideo VOD. Para obter mais informações sobre o procedimento e os limites, consulte HTTP callbacks e SMQ callbacks.

Especifique URLs de callback no UserData durante o upload

Limites

• Especifique o parâmetro UserData exclusivamente pelo SDK ou pela API do ApsaraVideo VOD.

• Ative o recurso de notificação global e defina os eventos para os quais deseja configurar callbacks. Caso contrário, as URLs de callback especificadas em UserData não terão efeito.

Observações de uso

Defina URLs de callback em UserData para arquivos de mídia enviados ao ApsaraVideo VOD com o SDK de operação do servidor ou o SDK de upload. A URL de callback vincula-se ao arquivo de source da mídia. As notificações de eventos são enviadas para esse endereço ao submeter jobs de processamento de mídia, como transcodificação e revisão. Os eventos com callbacks configurados constam nas configurações globais de callback. Se você excluir o arquivo de recurso de mídia, as notificações subsequentes serão direcionadas à URL de callback definida nas configurações globais.

Operações relacionadas

Para obter mais detalhes sobre como usar o SDK de operação do servidor ou o SDK de upload, consulte Usage notes e Overview.

Defina o parâmetro UserData ao chamar as operações a seguir para fazer upload de arquivos de mídia:

• CreateUploadVideo

• CreateUploadImage

• CreateUploadAttachedMedia

• UploadMediaByURL

• RegisterMedia

Especifique URLs de callback no UserData durante o processamento de mídia

Limites

• Especifique o parâmetro UserData apenas pelo SDK ou pela API do ApsaraVideo VOD.

• Ative o recurso de notificação global e indique os eventos que receberão callbacks. Sem isso, as URLs de callback informadas em UserData não funcionarão.

Observações de uso

Ao submeter jobs de processamento de mídia, como tarefas de transcodificação, pelo SDK ou pela API do ApsaraVideo VOD, especifique as URLs de callback em UserData.

A URL de callback definida em UserData durante o processamento de mídia vale apenas para um único evento. Se nenhuma URL for especificada nessa etapa, o sistema usará preferencialmente as URLs definidas em UserData no momento do upload antes de recorrer às URLs das configurações globais de callback.

Operações relacionadas

Especifique o parâmetro UserData ao chamar as operações a seguir para submeter jobs de processamento de mídia:

• SubmitTranscodeJobs

• SubmitSnapshotJob

• SubmitAIMediaAuditJob

• ProduceEditingProjectVideo

Código de exemplo

Para obter mais informações sobre a estrutura do parâmetro UserData, consulte Request parameters. O exemplo a seguir ilustra a estrutura do 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"
    }
}

O exemplo a seguir demonstra como construir o 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();
    }

Referências

• Event notifications

• FAQ about event notifications