You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储SDK 参考Java数据处理音频处理创建音频转码任务（Java SDK）
复制全文
下载 pdf
我的收藏
音频处理
创建音频转码任务（Java SDK）
复制全文
下载 pdf
我的收藏
创建音频转码任务（Java SDK）
本文介绍如何通过 TOS Java SDK 创建音频转码任务。​
注意事项​
仅 Java SDK 2.9.8 及以上版本支持创建音频转码任务的功能。​
示例代码​
​
// 使用配置创建音频转码任务​
import com.volcengine.tos.TOSV2;​
import com.volcengine.tos.TOSV2ClientBuilder;​
import com.volcengine.tos.TosClientException;​
import com.volcengine.tos.TosServerException;​
import com.volcengine.tos.comm.common.*;​
import com.volcengine.tos.model.bucket.*;​
import com.volcengine.tos.model.object.*;​
​
public class CreateAudioConvertJobExample {​
public static void main(String[] args) {​
String endpoint = System.getenv("TOS_ENDPOINT");​
String region = System.getenv("TOS_REGION");​
String accessKey = System.getenv("TOS_ACCESS_KEY");​
String secretKey = System.getenv("TOS_SECRET_KEY");​
​
// 填写 BucketName​
String bucketName = System.getenv("TOS_BUCKET");​
​
// 初始化客户端​
TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);​
​
try {​
// 1. 准备源对象和目标对象 Key（占位符示例，实际使用时请替换为真实对象名）​
String srcObject = "input-audio.mp3"; // 源音频对象 Key​
String targetObject = "output-audio.mp3"; // 转码后音频对象 Key​
​
// 2. 配置时间区间：从 1000 ms 开始，持续 10000 ms​
TimeInterval timeInterval = TimeInterval.builder()​
.start(1000) // 截取开始时间，单位毫秒​
.duration(10000) // 截取持续时间，单位毫秒​
.build();​
​
// 3. 构建音频转码配置​
AudioConvertConfig audioConvertConfig = AudioConvertConfig.builder()​
.timeInterval(timeInterval) // 音频处理的时间区间​
.containerFormat(AudioContainerFormatType.MP3) // 输出音频容器格式：MP3​
.bitRate(8000) // 音频比特率，单位 bps​
.bitRateOpt(1) // 码率控制参数，示例取值 1​
.sampleFormat("fltp") // 采样格式，例如 fltp​
.sampleRate(11025) // 采样率，单位 Hz​
.channels(2) // 声道数，2 表示立体声​
.build();​
​
// 4. 构建任务输入：指定源对象​
ConvertJobInput jobInput = ConvertJobInput.builder()​
.object(srcObject)​
.build();​
​
// 5. 构建任务输出：指定输出区域、桶名和目标对象​
ConvertJobOutput jobOutput = ConvertJobOutput.builder()​
.region(region) // 结果输出所在区域​
.bucket(bucketName) // 结果输出所在桶​
.object(targetObject) // 转码后的音频对象 Key​
.build();​
​
// 6. 组装创建音频转码任务请求​
CreateAudioConvertJobInput input = CreateAudioConvertJobInput.builder()​
.bucket(bucketName) // 任务所属桶​
.input(jobInput) // 源对象配置​
.audioConvertConfig(audioConvertConfig) // 音频转码配置​
.output(jobOutput) // 输出结果配置​
.build();​
​
// 7. 调用创建音频转码任务接口​
CreateAudioConvertJobOutput output = tos.createAudioConvertJob(input);​
​
// 8. 打印关键返回信息​
System.out.println("创建音频转码任务成功");​
System.out.println("JobId: " + output.getJobId());​
System.out.println("RequestID: " + output.getRequestInfo().getRequestId());​
System.out.println("StatusCode: " + output.getRequestInfo().getStatusCode());​
​
} catch (TosClientException e) {​
// 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送​
System.out.println("操作失败");​
System.out.println("Message: " + e.getMessage());​
if (e.getCause() != null) {​
e.getCause().printStackTrace();​
}​
} catch (TosServerException e) {​
// 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息​
System.out.println("操作失败");​
System.out.println("StatusCode: " + e.getStatusCode());​
System.out.println("Code: " + e.getCode());​
System.out.println("Message: " + e.getMessage());​
System.out.println("RequestID: " + e.getRequestID());​
} catch (Throwable t) {​
// 作为兜底捕获其他异常，一般不会执行到这里​
System.out.println("操作失败");​
System.out.println("unexpected exception, message: " + t.getMessage());​
}​
}​
}​
​
相关文档 ​
关于创建音频转码任务的相关API接口，请参见CreateAudioConvertJob。​
最近更新时间：2026.04.03 17:59:07
这个页面对您有帮助吗？
有用
有用
无用
无用