全部產品
Search
文件中心

ApsaraVideo VOD:微短劇服務端最佳實務

更新時間:Dec 06, 2025

微短劇解決方案的服務端旨在支援微短劇媒體的上傳、管理與處理。通過閱讀本文,您將瞭解微短劇解決方案的前期準備工作。

控制台工作

  • 您已經開通了ApsaraVideo for VOD服務。開通步驟請參見開通ApsaraVideo for VOD服務

  • 您已經完成上傳相關的系統配置,包括啟用目標儲存地區的儲存地址和配置回調。操作指引請參見管理儲存Bucket回調設定

  • 您已準備好用於調用點播服務的帳號。為避免阿里雲帳號AccessKey泄露帶來的安全風險,推薦您建立RAM使用者並授予其VOD相關許可權。然後使用RAM使用者的AK對(AccessKey ID和AccessKey Secret)訪問點播服務。操作指引請參見建立RAM使用者並授權

  • 已配置環境變數ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET。具體操作,請參見在Linux、macOS和Windows系統配置環境變數

    重要
    • 阿里雲帳號的AccessKey擁有所有API的存取權限,建議您使用RAM使用者的AccessKey進行API訪問或日常營運。

    • 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡,否則可能導致AccessKey泄露,威脅您帳號下所有資源的安全。

整合Java上傳SDK

說明

本文以Java 1.8及以上版本、Java上傳SDK 1.4.15版本舉例說明整合步驟。其他版本請根據實際情況操作。上傳SDK暫不支援依賴,您需要下載並引入jar包。如果整合遇到問題,請參見常見問題排查。

  1. 下載Java上傳SDK及範例程式碼。

  2. 解壓Java上傳SDK及範例程式碼檔案。

    以最新版本VODUploadDemo-java-1.4.15.zip為例,解壓後的檔案如下:

    • lib:存放Java上傳SDK所需要的jar包。

    • sample:存放Java上傳SDK的範例程式碼。

  3. 引入Jar包。

    • 如果您在Eclipse環境整合:在Eclipse中右擊您的工程,選擇Properties > Java Build Path > Add JARs。找到解壓後的VODUploadDemo-java-1.4.15檔案,並將lib目錄下的所有jar檔案添加到您的專案中。

    • 如果您在IntelliJ IDEA整合:在IntelliJ IDEA中開啟您的工程,選擇File > Project Structure > Modules,單擊右側Dependencies,然後單擊+,再單擊JARs or directories。找到解壓後的VODUploadDemo-java-1.4.15檔案,並將lib目錄下的所有jar檔案添加到您的專案中。

    重要

    引入Jar包後仍然需要配置依賴。

  4. 添加阿里雲Java SDK、OSS SDK、ApsaraVideo for VOD服務端SDK、ApsaraVideo for VOD服務端上傳SDK等依賴。

    重要
    • 以上依賴必須全部匯入,否則會導致整合失敗。

    • 使用最新版本Jar包(aliyun-java-vod-upload-1.4.15.jar)時,需保證aliyun-sdk-oss的版本號碼不低於3.9.0,aliyun-java-sdk-vod的版本號碼不低於2.16.11。

    • 目前ApsaraVideo for VOD已在中國內地發布的地區有上海、深圳、北京。若使用1.4.14及以前版本的上傳SDK上傳到深圳、北京地區時,需保證aliyun-java-sdk-vod版本號碼不低於2.15.11、aliyun-java-sdk-core版本號碼不低於4.4.5;若使用1.4.15及以後版本的上傳SDK上傳到深圳、北京地區時,需保證aliyun-java-sdk-vod版本號碼不低於2.16.11、aliyun-java-sdk-core版本號碼不低於4.4.5。

    展開查看依賴

       <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>4.5.1</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.10.2</version>
        </dependency>
         <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-vod</artifactId>
            <version>2.16.11</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.83</version>
        </dependency>
        <dependency>
            <groupId>org.json</groupId>
            <artifactId>json</artifactId>
            <version>20170516</version>
        </dependency>
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.8.2</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun.vod</groupId>
            <artifactId>upload</artifactId>
            <version>1.4.15</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/src/main/resources/aliyun-java-vod-upload-1.4.15.jar</systemPath>
        </dependency>