本文档旨在指导您快速地将视频点播服务端 SDK 集成到您的项目中，并完成初始化。

环境要求

JDK 1.8 或更高版本。

集成步骤

步骤 1：添加 SDK 依赖

Java SDK 通过 Maven 进行管理。您需要在项目的 pom.xml 文件中添加以下依赖来引入 SDK。

<dependency>
    <groupId>com.volcengine</groupId>
    <artifactId>volc-sdk-java</artifactId>
    <version>版本号</version> <!-- 推荐使用最新版本 -->
</dependency>

步骤 2：配置访问凭证（AK/SK）

为了让 SDK 能够验证您的身份并发起 API 调用，您需要配置访问密钥（Access Key）。

方式 1：通过环境变量配置（推荐）

此方式将敏感信息与代码解耦，提升了安全性。您只需在运行程序的服务器环境中设置以下两个环境变量即可，SDK 会自动读取。

export VOLC_ACCESSKEY="Your_AK"
export VOLC_SECRETKEY="Your_SK"

方式 2：通过配置文件配置

您可以在用户主目录（~）下创建一个 .volc/config 文件，并按以下 JSON 格式填入您的 AK 和 SK。SDK 会自动从此路径加载凭证。

{
   "ak":"Your_AK",
   "sk":"Your_SK"
}

方式 3：在代码中显式设置

在某些临时测试或特殊场景下，您也可以在代码中直接设置 AK 和 SK。

IVodService vodService = VodServiceImpl.getInstance();
vodService.setAccessKey("Your_AK");
vodService.setSecretKey("Your_SK");

步骤 3：初始化客户端实例

完成依赖添加和凭证配置后，您就可以初始化视频点播服务的客户端实例 IVodService 了。

场景 1：创建默认实例

最简单的方式是创建一个使用默认地域（华北1 cn-north-1）的实例。

package com.volcengine.example;

import com.volcengine.helper.Const;
import com.volcengine.service.vod.IVodService;
import com.volcengine.service.vod.impl.VodServiceImpl;

// ...

// 如果您已通过环境变量或配置文件设置了 AK/SK，则无需再调用 setAccessKey/setSecretKey
IVodService vodService = VodServiceImpl.getInstance();

场景 2：创建指定地域的实例

如果您的业务需要访问特定地域（Region）的服务，可以在初始化时传入地域参数。

package com.volcengine.example;

import com.volcengine.helper.Const;
import com.volcengine.service.vod.IVodService;
import com.volcengine.service.vod.impl.VodServiceImpl;

// 创建一个华北1 (cn-north-1) 地域的实例
IVodService vodServiceNorth1 = VodServiceImpl.getInstance(Const.REGION_CN_NORTH_1);

// 创建一个亚太东南1 (ap-southeast-1) 地域的实例
// 注意：亚太东南（柔佛）地域需要 v1.0.145 或更高版本的 SDK
IVodService vodServiceApSouthEast1 = VodServiceImpl.getInstance(Const.REGION_AP_SOUTHEAST_1);

步骤 4：发起 API 请求

创建 vodService 实例后，您就可以调用其下的具体方法来发起 API 请求了。不同功能模块的接口调用示例，请参见以下文档：

• 空间管理
• 媒资上传
• 媒资管理
• 视频剪辑
• 媒体处理
• 音视频播放
• 点播 CDN
• 数据统计
• 工具服务
• 事件通知