遷移場(chǎng)景及方法

視頻點(diǎn)播提供了多種方式進(jìn)行資源遷移，支持將第三方資源（存儲(chǔ)于個(gè)人網(wǎng)站、云端的視頻等第三方數(shù)據(jù)資源）、同賬號(hào)或跨賬號(hào)下的OSS資源及點(diǎn)播資源遷移到視頻點(diǎn)播中。

資源遷移成功之后，資源將會(huì)在視頻點(diǎn)播中生成新的視頻ID、播放地址、封面地址等視頻信息，您需要自行關(guān)聯(lián)遷移前后的視頻資源關(guān)系。

準(zhǔn)備工作

• 您已經(jīng)注冊(cè)了阿里云賬號(hào)并完成賬號(hào)實(shí)名認(rèn)證。注冊(cè)地址請(qǐng)參見(jiàn)阿里云官網(wǎng)。注冊(cè)指引請(qǐng)參見(jiàn)注冊(cè)阿里云賬號(hào)。實(shí)名認(rèn)證指引請(qǐng)參見(jiàn)個(gè)人實(shí)名認(rèn)證或企業(yè)實(shí)名認(rèn)證。

• 調(diào)用服務(wù)端接口需要使用AccessKey完成身份驗(yàn)證，請(qǐng)?zhí)崆矮@取AccessKey。獲取方法請(qǐng)參見(jiàn)創(chuàng)建AccessKey。

  說(shuō)明

  如果使用RAM用戶(hù)完成遷移，請(qǐng)先創(chuàng)建RAM用戶(hù)再獲取AccessKey。詳細(xì)步驟請(qǐng)參見(jiàn)RAM子賬號(hào)訪問(wèn)。

URL批量拉取上傳（推薦）

使用場(chǎng)景

如果需要遷移的文件沒(méi)有存儲(chǔ)在本地服務(wù)器或終端，需要通過(guò)公網(wǎng)訪問(wèn)URL地址進(jìn)行資源訪問(wèn)遷移時(shí)，推薦您使用URL批量拉取的方式進(jìn)行上傳。該方式的優(yōu)勢(shì)在于能夠快速上傳大量文件，同時(shí)上傳過(guò)程采用內(nèi)網(wǎng)上傳方式，節(jié)省上傳流量。

使用限制

URL批量拉取上傳目前僅支持在華東2（上海）和新加坡地域使用，其他地域的用戶(hù)建議您使用其他方式進(jìn)行資源遷移。

注意事項(xiàng)

• URL批量拉取上傳是異步任務(wù)，非實(shí)時(shí)，不保證時(shí)效性，一般提交后會(huì)在數(shù)小時(shí)、甚至數(shù)天內(nèi)完成遷移上傳。如果對(duì)時(shí)效性要求較高，建議使用上傳SDK上傳。

• 同一個(gè)媒體文件URL，每次提交上傳任務(wù)都會(huì)在點(diǎn)播中產(chǎn)生一個(gè)新的媒體資源（即產(chǎn)生新的媒體ID）。

遷移流程

操作步驟

1. 集成視頻點(diǎn)播服務(wù)端SDK。

   本文以集成Java SDK為例完成后續(xù)操作，更多語(yǔ)言的使用，請(qǐng)參見(jiàn)服務(wù)端SDK。

   下載Java SDK請(qǐng)參見(jiàn)服務(wù)端SDK，安裝Java SDK請(qǐng)參見(jiàn)安裝。

2. 準(zhǔn)備需要遷移的資源。

   說(shuō)明

   • 用戶(hù)需要準(zhǔn)備所有遷移文件的下載地址，需要注意下載地址如果存在鑒權(quán)，盡量保證鑒權(quán)時(shí)間夠長(zhǎng)，避免下載時(shí)文件下載地址失效。

   • 文件的下載地址必須是包含文件擴(kuò)展名的完整路徑，例如：https://****.mp4。

3. 通過(guò)點(diǎn)播服務(wù)端SDK調(diào)用UploadMediaByURL - URL批量拉取上傳接口完成批量上傳。

   以下提供Java語(yǔ)言的調(diào)用示例，更多語(yǔ)言的調(diào)用示例，請(qǐng)參見(jiàn)URL批量拉取上傳。

   您也可以通過(guò)OpenAPI開(kāi)發(fā)者門(mén)戶(hù)在線(xiàn)調(diào)試。

   展開(kāi)查看Java示例代碼

   import com.alibaba.fastjson.JSON;
   import com.alibaba.fastjson.JSONArray;
   import com.alibaba.fastjson.JSONObject;
   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.auth.AlibabaCloudCredentials;
   import com.aliyuncs.auth.EnvironmentVariableCredentialsProvider;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.vod.model.v20170321.UploadMediaByURLRequest;
   import com.aliyuncs.vod.model.v20170321.UploadMediaByURLResponse;
   
   import java.net.URLEncoder;
   
   /**
    * URL批量拉取上傳功能示例
    *
    */
   public class AudioOrVideoUploadByUrl {
   
       /** 
        * 讀取AccessKey信息
        */
       public static DefaultAcsClient initVodClient() throws ClientException {
       // 點(diǎn)播服務(wù)接入地域
       String regionId = "cn-shanghai"; 
       // 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限，建議您使用RAM用戶(hù)進(jìn)行API訪問(wèn)或日常運(yùn)維。
       // 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號(hào)下所有資源的安全。
       // 本示例通過(guò)從環(huán)境變量中讀取AccessKey，來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。運(yùn)行代碼示例前，請(qǐng)配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
       DefaultProfile profile = DefaultProfile.getProfile(regionId, System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
       DefaultAcsClient client = new DefaultAcsClient(profile);
       return client;
       }
   
       /**
        * URL批量拉取上傳
        *
        * @param client 發(fā)送請(qǐng)求客戶(hù)端
        * @return UploadMediaByURLResponse URL批量拉取上傳響應(yīng)數(shù)據(jù)
        * @throws Exception
        */
       public static UploadMediaByURLResponse uploadMediaByURL(DefaultAcsClient client) throws Exception {
           UploadMediaByURLRequest request = new UploadMediaByURLRequest();
           String url = "http://video_01.mp4";
           String encodeUrl = URLEncoder.encode(url, "UTF-8");
           //視頻源文件URL
           request.setUploadURLs(encodeUrl);
   
           //上傳視頻元數(shù)據(jù)信息
           JSONObject uploadMetadata = new JSONObject();
           //需要上傳的視頻源文件URL，與UploadURLs里的URL匹配才能生效
           uploadMetadata.put("SourceUrl", encodeUrl);
           //視頻標(biāo)題
           uploadMetadata.put("Title", "upload by url sample");
   
           JSONArray uploadMetadataList = new JSONArray();
           uploadMetadataList.add(uploadMetadata);
           request.setUploadMetadatas(uploadMetadataList.toJSONString());
   
           //UserData，用戶(hù)自定義設(shè)置參數(shù)，用戶(hù)需要單獨(dú)回調(diào)URL及數(shù)據(jù)透?jìng)鲿r(shí)設(shè)置（非必須）
           JSONObject userData = new JSONObject();
   
           //UserData回調(diào)部分設(shè)置
           //消息回調(diào)設(shè)置，指定時(shí)以此為準(zhǔn)，否則以全局設(shè)置的事件通知為準(zhǔn)
           JSONObject messageCallback = new JSONObject();
           //設(shè)置回調(diào)地址
           messageCallback.put("CallbackURL", "http://192.168.0.0/16");
           //設(shè)置回調(diào)類(lèi)型，默認(rèn)為http
           messageCallback.put("CallbackType", "http");
           userData.put("MessageCallback", messageCallback.toJSONString());
   
           JSONObject extend = new JSONObject();
           extend.put("MyId", "user-defined-id");
           userData.put("Extend", extend.toJSONString());
   
           request.setUserData(userData.toJSONString());
   
           return client.getAcsResponse(request);
       }
   
       /** 
        * 請(qǐng)求示例
        */
       public static void main(String[] argv) {
   
           try {
               DefaultAcsClient client = initVodClient();
               UploadMediaByURLResponse response = uploadMediaByURL(client);
               System.out.print("UploadJobs = " + JSON.toJSONString(response.getUploadJobs()) + "\n");
               System.out.print("RequestId = " + response.getRequestId() + "\n");
           } catch (Exception e) {
               System.out.print("ErrorMessage = " + e.getLocalizedMessage());
           }
       }
   
   }

4. 獲取上傳結(jié)果。

   方式一：事件通知

   視頻點(diǎn)播支持HTTP回調(diào)和MNS回調(diào)兩種方式的事件通知，通過(guò)提前配置事件通知，當(dāng)媒體文件處理完成（如上傳完成、轉(zhuǎn)碼完成等）后，視頻點(diǎn)播服務(wù)會(huì)根據(jù)您配置的回調(diào)方式及時(shí)通知您。配置詳情請(qǐng)參見(jiàn)事件通知。

   URL批量拉取上傳的事件類(lèi)型為URL上傳視頻完成。您可以從接收到的回調(diào)結(jié)果中獲取到上傳任務(wù)的狀態(tài)等信息。

   • 上傳成功回調(diào)示例

     { 
       "Status": "success",
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "UploadByURLComplete", 
       "VideoId": "43q9fjdun3f****", 
       "JobId": "4c815bjs83j1****", 
       "SourceURL ": "http://example.aliyundoc.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4",
       "Size":"123456"
     }

   • 上傳失敗回調(diào)示例

     { 
       "Status": "fail",
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "UploadByURLComplete", 
       "ErrorCode ": "URLInvalidError ", 
       "ErrorMessage ": "download video failed by the url, please check it", 
       "JobId": "4c815bjsued****" ,
       "SourceURL ": "http://example.aliyundoc.com/27ffc438-164d55217ef-0005-6884-51a-1****.mp4",
     }

   方式二：調(diào)用API查詢(xún)

   調(diào)用GetURLUploadInfos - 獲取URL上傳信息接口來(lái)查詢(xún)指定URL拉取上傳任務(wù)的執(zhí)行狀態(tài)等信息。

自行下載文件并搭建上傳服務(wù)上傳

當(dāng)您的服務(wù)地域不支持使用URL批量拉取方式上傳或您對(duì)上傳實(shí)時(shí)性要求較高時(shí)，您可以自行下載文件并使用視頻點(diǎn)播提供的上傳SDK進(jìn)行上傳。如果您把上傳服務(wù)部署在ECS上，根據(jù)您的ECS地域的不同可以選擇內(nèi)網(wǎng)上傳和公網(wǎng)上傳兩種方式進(jìn)行資源遷移。

將OSS自有Bucket添加到視頻點(diǎn)播并注冊(cè)資源

使用場(chǎng)景

適用于資源存儲(chǔ)在同賬號(hào)下的OSS Bucket時(shí)，無(wú)需二次上傳，直接通過(guò)將OSS自有Bucket添加到視頻點(diǎn)播中后并注冊(cè)資源來(lái)達(dá)到遷移資源的目的。

使用限制

• 目前僅支持將標(biāo)準(zhǔn)存儲(chǔ)類(lèi)型的OSS Bucket添加到視頻點(diǎn)播中。

• 每個(gè)服務(wù)地域下最多僅支持添加10個(gè)OSS自有Bucket。

操作步驟

1. 將需要遷移資源的OSS自有Bucket添加到視頻點(diǎn)播中。

   詳細(xì)的操作步驟及參數(shù)解釋?zhuān)?qǐng)參見(jiàn)添加OSS自有Bucket。

2. 通過(guò)接口將OSS中的資源注冊(cè)到視頻點(diǎn)播中。

   1. 使用OSS的API/SDK，列舉bucket下的所有文件，得到object列表。詳情請(qǐng)參見(jiàn)列舉文件。

   2. 調(diào)用RegisterMedia - 注冊(cè)媒資信息接口注冊(cè)媒資文件生成音/視頻ID，其中，RegisterMetadatas中的FileURL參數(shù)為OSS列舉文件得到的object的完整路徑，即必須加上OSS域名地址，例如：

      https://oss-cn-hangzhou.aliyuncs.com/video/example.mp4

上傳服務(wù)搭建及代碼示例

無(wú)論是第三方資源還是阿里云賬號(hào)間資源遷移，都需要下載原視頻再通過(guò)上傳工具上傳到視頻點(diǎn)播。視頻點(diǎn)播提供上傳SDK及服務(wù)端接口兩種上傳工具。您的上傳服務(wù)可通過(guò)上傳SDK或服務(wù)端接口實(shí)現(xiàn)。使用上傳SDK為同步上傳，更具實(shí)效性，故推薦使用。使用服務(wù)端接口較為繁瑣，故不推薦。

搭建上傳服務(wù)步驟

1. 集成上傳SDK或服務(wù)端SDK。

   根據(jù)您使用的語(yǔ)言，集成上傳SDK請(qǐng)參考上傳SDK，集成服務(wù)端SDK請(qǐng)參考服務(wù)端SDK。

2. 編寫(xiě)上傳服務(wù)代碼。如何編寫(xiě)請(qǐng)參考下述代碼示例。

上傳SDK代碼示例（推薦）

以下代碼僅以Java上傳SDK為例展示。更多語(yǔ)言的上傳SDK及操作示例，請(qǐng)參考上傳SDK。

import com.aliyun.vod.upload.impl.UploadVideoImpl;
import com.aliyun.vod.upload.req.UploadStreamRequest;
import com.aliyun.vod.upload.resp.UploadStreamResponse;
import java.io.*;
import java.net.URL;

/**
 * 使用上傳SDK進(jìn)行視頻文件上傳
 */
public class UploadStreamDemo {
    /**
     * 流式上傳接口
     *
     * @param accessKeyId
     * @param accessKeySecret
     * @param title
     * @param fileName
     * @param inputStream
     */
    private static void testUploadStream(String accessKeyId, String accessKeySecret, String title, String fileName, InputStream inputStream) {
        UploadStreamRequest request = new UploadStreamRequest(accessKeyId, accessKeySecret, title, fileName, inputStream);
        
        /* 自定義消息回調(diào)設(shè)置，參數(shù)說(shuō)明請(qǐng)參見(jiàn)基本數(shù)據(jù)類(lèi)型 */
        //request.setUserData(""{\"Extend\":{\"test\":\"www\",\"localId\":\"xxxx\"},\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"}}"");
        /* 視頻分類(lèi)ID（可選） */
        //request.setCateId(0);
        /* 視頻標(biāo)簽，多個(gè)用逗號(hào)分隔（可選） */
        //request.setTags("標(biāo)簽1,標(biāo)簽2");
        /* 視頻描述（可選） */
        //request.setDescription("視頻描述");
        /* 封面圖片（可選），如http://****.example.com/image_01.jpg*/
        //request.setCoverURL("<Your CoverURL>");
        /* 模板組ID（可選） */
        //request.setTemplateGroupId("8c4792cbc8694e****fd5330e56a33d");
        /* 工作流ID（可選） */
        //request.setWorkflowId("d4430d07361f****1339577859b0177b");
        /* 存儲(chǔ)區(qū)域（可選） */
        //request.setStorageLocation("outin-20170323****266-5sejdln9o.oss-cn-shanghai.aliyuncs.com");
        /* 點(diǎn)播服務(wù)接入點(diǎn) */
        request.setApiRegionId("cn-shanghai");
        /* ECS部署區(qū)域*/
        // request.setEcsRegionId("cn-shanghai");
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);
        System.out.print("RequestId=" + response.getRequestId() + "\n");  //請(qǐng)求視頻點(diǎn)播服務(wù)的請(qǐng)求ID
        if (response.isSuccess()) {
            System.out.print("VideoId=" + response.getVideoId() + "\n");
        } else { //如果設(shè)置回調(diào)URL無(wú)效，不影響視頻上傳，可以返回VideoId同時(shí)會(huì)返回錯(cuò)誤碼。其他情況上傳失敗時(shí)，VideoId為空，此時(shí)需要根據(jù)返回錯(cuò)誤碼分析具體錯(cuò)誤原因
            System.out.print("VideoId=" + response.getVideoId() + "\n");
            System.out.print("ErrorCode=" + response.getCode() + "\n");
            System.out.print("ErrorMessage=" + response.getMessage() + "\n");
        }
    }

    public static void main(String[] args) {
        /**
         * 用戶(hù)可自行添加url數(shù)據(jù)源,并傳入視頻媒資信息，上傳視頻資源
         */
        InputStream inputStream = null;
        //您的視頻地址。如http://example.aliyundoc.com/video/****.mp4
        String url = "<Your File URL>";
        try {
            inputStream = new URL(url).openStream();
        } catch (IOException e) {
            e.printStackTrace();
        }
        // 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限，建議您使用RAM用戶(hù)進(jìn)行API訪問(wèn)或日常運(yùn)維。
        // 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導(dǎo)致AccessKey泄露，威脅您賬號(hào)下所有資源的安全。
        // 本示例通過(guò)從環(huán)境變量中讀取AccessKey，來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。運(yùn)行代碼示例前，請(qǐng)配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        //以下參數(shù)中的AccessKey ID, AccessKey Secret為提前準(zhǔn)備好的AccessKey信息。<Your Video Title>為視頻標(biāo)題。<Your Video with File Extension>為含文件擴(kuò)展名的視頻，如video-1.mp4。
        testUploadStream(accessKeyId, accessKeySecret, "<Your Video Title>", "<Your Video with File Extension>", inputStream);
    }
}

服務(wù)端API代碼示例（不推薦）

集成服務(wù)端SDK并進(jìn)行上傳，需要開(kāi)發(fā)者自行實(shí)現(xiàn)所有上傳邏輯，包括在點(diǎn)播服務(wù)獲取上傳地址和憑證、Base64解碼上傳憑證和地址、以及調(diào)用OSS能力完成上傳。此方式較為繁瑣且出錯(cuò)率較高，因此不推薦使用。完整的上傳邏輯請(qǐng)參見(jiàn)通過(guò)視頻點(diǎn)播API上傳媒資文件。