本文为您介绍如何使用视频点播服务端 Java SDK 将音频、视频、图片等媒资文件上传至视频点播服务。 ## 费用说明媒资上传到视频点播中会产生存储费用，具体参见[媒资存储计费](https://www.volcengine.com/docs/4/76542#%E5%AA%92%E8%B5%84%E5%AD%98%E5%82%A8)。 ## 前提条件 * 已完成[集成 Java SDK](/docs/4/65639)。 * 已[创建空间](https://www.volcengine.com/docs/4/107709)。 * 上传前，请确保您已阅读[媒资上传概述](https://www.volcengine.com/docs/4/2887)了解媒资上传功能、视频点播支持的媒资类型、格式和大小限制。 ## 上传音视频 ### 直接上传本地文件视频点播服务端 SDK 封装了 [ApplyUploadInfo - 获取上传地址和凭证](https://www.volcengine.com/docs/4/164295)和 [CommitUploadInfo - 确认上传](https://www.volcengine.com/docs/4/164296)接口以及上传逻辑，您只需简单配置即可进行上传。 :::tip * 完整的上传流程请见[服务端上传](https://www.volcengine.com/docs/4/3028)。 * 上传任务成功提交后，您可通过[媒资上传完成事件](https://www.volcengine.com/docs/4/4655)通知获取任务结果。配置方式请见[事件通知概述](https://www.volcengine.com/docs/4/4656)。 * 上传文件时必须携带文件后缀。例如，如需上传 MP4 文件，携带 `.mp4` 或 `.MP4`。 * 以下示例为 2022-01-01 版本的 ApplyUploadInfo 和 CommitUploadInfo 接口。若您使用 2020-08-01 版本，示例代码请见[历史版本](/docs/4/65640#93ab9329)。 ::: ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.helper.VodUploadMediaProcessListener; import com.volcengine.helper.VodUploadProgressListener; import com.volcengine.model.beans.Functions; import com.volcengine.model.beans.FunctionsWorkflowTemplate; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.business.VodUploadTemplate; import com.volcengine.service.vod.model.request.VodUploadMediaRequest; import com.volcengine.service.vod.model.response.VodCommitUploadInfoResponse; import java.util.ArrayList; import java.util.List; public class VodUploadMediaDemo { public static void main(String[] args) { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); // 点播空间名称 String space = "your space name"; // 文件路径 String filePath = "your file path"; // 上传功能函数，可用于实现截图、设置媒资信息、触发工作流进行转码等功能。详见[上传功能函数说明](https://www.volcengine.com/docs/4/1185644) List functionsList = new ArrayList<>(); Functions getMetaFunc = Functions.GetMetaFunction(); functionsList.add(getMetaFunc); Functions snapShotFunc = Functions.SnapShotFunction(2.3); functionsList.add(snapShotFunc); Functions addOptionInfo = Functions.AddOptionInfoFunction("hls测试视频", "test", "素材测试，视频文件", 0, true); functionsList.add(addOptionInfo); List impTemplateIds = new ArrayList<>(); impTemplateIds.add("imp template id"); FunctionsWorkflowTemplate impTemplate = new FunctionsWorkflowTemplate(impTemplateIds, "imp"); List transcodeTemplateIds = new ArrayList<>(); transcodeTemplateIds.add("transcode template id"); FunctionsWorkflowTemplate transcodeTemplate = new FunctionsWorkflowTemplate(transcodeTemplateIds, "transcode"); List templates = new ArrayList<>(); templates.add(impTemplate); templates.add(transcodeTemplate); Functions workflowFunc = Functions.StartWorkFlowFunction(templates); functionsList.add(workflowFunc); VodUploadMediaRequest vodUploadMediaRequest = VodUploadMediaRequest.newBuilder() .setSpaceName(space) .setFilePath(filePath) .setFileName("hello/vod/video.mp4") .setFunctions(JSON.toJSONString(functionsList)) .setStorageClass(1) // .setUploadHostPrefer("") .build(); // 需要进度条功能时添加相应 listener，如无需求，传 null 值即可 VodUploadProgressListener listener = new VodUploadMediaProcessListener(); try { VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMedia(vodUploadMediaRequest, listener); if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); System.exit(-1); } System.out.println(vodCommitUploadInfoResponse.toString()); System.out.println(vodCommitUploadInfoResponse.getResult().getData().getVid()); System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); } catch (Exception e) { e.printStackTrace(); } } } ``` ### URL 批量拉取上传视频点播服务端 SDK 封装了 [URL 批量拉取上传 - UploadMediaByUrl](https://www.volcengine.com/docs/4/4652) 接口，您只需简单配置即可进行上传。完整的上传流程请见[服务端上传](https://www.volcengine.com/docs/4/3028)。 :::tip * 本接口主要适用于文件没有存储在本地服务器或终端，需要通过公网访问的 URL 地址上传的场景。源文件 URL 支持 HTTP 和 HTTPS。 * 本接口为异步上传接口。上传任务成功提交后，系统会生成异步执行的任务，排队执行，不保证时效性。 * 本接口的请求参数和返回参数说明详见 [UploadMediaByUrl](https://www.volcengine.com/docs/4/4652)。 * 上传任务成功提交后，可通过以下方式获取任务结果： * 调用 [QueryUploadTaskInfo](https://www.volcengine.com/docs/4/65622) 接口查询 URL 批量上传任务状态。 * 配置 [URL 批量拉取上传完成事件](https://www.volcengine.com/docs/4/4757)通知。每个 URL 上传完成时您都将收到通知。配置方式请见[事件通知概述](https://www.volcengine.com/docs/4/4656)。 ::: ```Java package com.volcengine.example.vod.upload; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.business.VodUploadTemplate; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; public class VodUploadMediaByUrlDemo { public static void main(String[] args) throws Exception { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); try { com.volcengine.service.vod.model.request.VodUrlUploadRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodUrlUploadRequest.newBuilder(); reqBuilder.setSpaceName("your space"); com.volcengine.service.vod.model.business.VodUrlUploadURLSet.Builder uRLSetsBuilder = com.volcengine.service.vod.model.business.VodUrlUploadURLSet.newBuilder(); uRLSetsBuilder.setSourceUrl(""); uRLSetsBuilder.setStorageClass(1); uRLSetsBuilder.setFileExtension(".mp4"); uRLSetsBuilder.setCallbackArgs("my java callback args"); Map customUrlHeaders = new HashMap<>(); customUrlHeaders.put("your header key", "your header value"); uRLSetsBuilder.putAllCustomURLHeaders(customUrlHeaders); VodUploadTemplate impTemplate = VodUploadTemplate.newBuilder() .addTemplateIds("imp template id") .setTemplateType("imp") .build(); VodUploadTemplate transcodeTemplate = VodUploadTemplate.newBuilder() .addTemplateIds( "transcode template id") .setTemplateType("transcode") .build(); uRLSetsBuilder.addTemplates(impTemplate); uRLSetsBuilder.addTemplates(transcodeTemplate); reqBuilder.addURLSets(uRLSetsBuilder); com.volcengine.service.vod.model.response.VodUrlUploadResponse resp = vodService.uploadMediaByUrl(reqBuilder.build()); if (resp.getResponseMetadata().hasError()) { System.out.println(resp.getResponseMetadata().getError()); System.exit(-1); } System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 流式上传 ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.helper.VodUploadMediaProcessListener; import com.volcengine.helper.VodUploadProgressListener; import com.volcengine.model.beans.Functions; import com.volcengine.model.beans.FunctionsWorkflowTemplate; import com.volcengine.model.request.vod.VodStreamUploadRequest; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.business.VodUploadTemplate; import com.volcengine.service.vod.model.request.VodUploadMediaRequest; import com.volcengine.service.vod.model.response.VodCommitUploadInfoResponse; import java.util.ArrayList; import java.util.List; public class VodUploadMediaDemo { // 上传流 public static void main(String[] args) { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); // 点播空间名称 String space = "your space name"; // 上传功能函数，可用于实现截图、设置媒资信息、触发工作流进行转码等功能。详见[上传功能函数说明](https://www.volcengine.com/docs/4/1185644) List functionsList = new ArrayList<>(); Functions getMetaFunc = Functions.GetMetaFunction(); functionsList.add(getMetaFunc); Functions snapShotFunc = Functions.SnapShotFunction(0); functionsList.add(snapShotFunc); Functions addOptionInfo = Functions.AddOptionInfoFunction("hls测试视频", "test", "素材测试，视频文件", 0, true); functionsList.add(addOptionInfo); List impTemplateIds = new ArrayList<>(); impTemplateIds.add("imp template id"); FunctionsWorkflowTemplate impTemplate = new FunctionsWorkflowTemplate(impTemplateIds, "imp"); List transcodeTemplateIds = new ArrayList<>(); transcodeTemplateIds.add("transcode template id"); FunctionsWorkflowTemplate transcodeTemplate = new FunctionsWorkflowTemplate(transcodeTemplateIds, "transcode"); List templates = new ArrayList<>(); templates.add(impTemplate); templates.add(transcodeTemplate); Functions workflowFunc = Functions.StartWorkFlowFunction(templates); functionsList.add(workflowFunc); VodStreamUploadRequest vodStreamUploadRequest = new VodStreamUploadRequest(); vodStreamUploadRequest.setSpaceName(space); vodStreamUploadRequest.setContent(null); vodStreamUploadRequest.setSize(0L); vodStreamUploadRequest.setChunkSize(0L); vodStreamUploadRequest.setFileName("hello/vod/video.mp4"); vodStreamUploadRequest.setFunctions(JSON.toJSONString(functionsList)); vodStreamUploadRequest.setStorageClass(1); try { VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.streamUploadMedia(vodStreamUploadRequest); if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); System.exit(-1); } System.out.println(vodCommitUploadInfoResponse.toString()); System.out.println(vodCommitUploadInfoResponse.getResult().getData().getVid()); System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); } catch (Exception e) { e.printStackTrace(); } } } ``` ## 上传素材视频点播服务端 SDK 封装了 [ApplyUploadInfo - 获取上传地址和凭证](https://www.volcengine.com/docs/4/164295)和 [CommitUploadInfo - 确认上传](https://www.volcengine.com/docs/4/164296)接口以及上传逻辑，您只需简单配置即可进行上传。 :::tip * 完整的上传流程请见[服务端上传](https://www.volcengine.com/docs/4/3028)。 * 上传任务成功提交后，您可通过[素材上传完成事件](https://www.volcengine.com/docs/4/70592)通知获取任务结果。配置方式请见[事件通知概述](https://www.volcengine.com/docs/4/4656)。 * 上传文件时必须携带文件后缀。例如，如需上传 MP4 文件，携带 `.mp4` 或 `.MP4`。 * 以下示例为 2022-01-01 版本的 ApplyUploadInfo 和 CommitUploadInfo 接口。若您使用 2020-08-01 版本，示例代码请见[历史版本](/docs/4/65640#93ab9329)。 ::: ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.service.vod.Const; import com.volcengine.model.beans.Functions; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.request.VodUploadMaterialRequest; import com.volcengine.model.request.vod.VodStreamUploadRequest; import com.volcengine.service.vod.model.response.VodCommitUploadInfoResponse; import java.util.ArrayList; import java.util.List; /** * 上传素材示例 * 本示例代码主要演示如何上传视频素材。 * 同时，代码中以注释块的形式提供了上传图片、上传字幕并绑定至指定视频等其他示例，你可以根据需要取消相应代码块的注释来进行测试。 */ public class VodUploadMaterialDemo { public static void main(String[] args) { // 1. 初始化 VOD 服务 // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // 2. 设置访问密钥 Access Key ID (AK) 和 Secret Access Key (SK) // 请在 ~/.volc/config 文件中配置 AK/SK，或通过环境变量设置，SDK 会自动读取。详细说明，请见 https://www.volcengine.com/docs/4/65641 // 测试阶段，可按需临时调用 setAccessKey 和 setSecretKey 方法进行设置。但是请不要将 AK/SK 直接存储在项目代码里，以防泄漏。 // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); // 3. 设置上传参数 String space = "your space name"; String filePath = "your file path"; // 上传功能函数，可用于实现截图、设置媒资信息、触发工作流进行转码等功能。详见[上传功能函数说明](https://www.volcengine.com/docs/4/1185644) List functionsList = new ArrayList<>(); Functions getMetaFunc = Functions.GetMetaFunction(); functionsList.add(getMetaFunc); // 截取指定时间的封面图 Functions snapShotFunc = Functions.SnapShotFunction(2.3); functionsList.add(snapShotFunc); // 添加视频标题、标签、分类等信息 Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试视频", "test", "素材测试，视频文件", Const.CategoryVideo, "mp4"); functionsList.add(addOptionInfo); VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() .setSpaceName(space) .setFilePath(filePath) .setFileType(Const.FileTypeMedia) .setFunctions(JSON.toJSONString(functionsList)) // .setUploadHostPrefer("") .build(); try { VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest, null); if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); System.exit(-1); } System.out.println(vodCommitUploadInfoResponse.toString()); System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); } catch (Exception e) { e.printStackTrace(); } } // // 视频素材流上传 // public static void main(String[] args) { // // Create a VOD instance in the specified region. // // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); // IVodService vodService = VodServiceImpl.getInstance(); // // // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // // vodService.setAccessKey("your ak"); // // vodService.setSecretKey("your sk"); // // String space = "your space name"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试视频", "test", "素材测试，视频文件", Const.CategoryVideo, "mp4"); // functionsList.add(addOptionInfo); // // VodStreamUploadRequest vodUploadMaterialRequest = new VodStreamUploadRequest(); // vodUploadMaterialRequest.setSpaceName(space); // vodUploadMaterialRequest.setFileType(Const.FileTypeMedia); // vodUploadMaterialRequest.setContent(null); // vodUploadMaterialRequest.setSize(0L); // vodUploadMaterialRequest.setChunkSize(0L); // vodUploadMaterialRequest.setFileName("hello/vod/material.mp4"); // vodUploadMaterialRequest.setFunctions(JSON.toJSONString(functionsList)); // vodUploadMaterialRequest.setStorageClass(1); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.streamUploadMaterial(vodUploadMaterialRequest); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } //// 图片素材上传 // public static void main(String[] args) { // // Create a VOD instance in the specified region. // // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); // IVodService vodService = VodServiceImpl.getInstance(); // // // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // // vodService.setAccessKey("your ak"); // // vodService.setSecretKey("your sk"); // // String space = "your space name"; // String filePath = "your file path"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试图片", "test", "素材测试，图片文件", Const.CategoryImage, "jpg"); // functionsList.add(addOptionInfo); // // VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() // .setSpaceName(space) // .setFilePath(filePath) // .setFileType(Const.FileTypeImage) // .setFileName("hello/vod/image.jpg") // .setFunctions(JSON.toJSONString(functionsList)) // .build(); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest,null); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } // // 图片素材流上传 // public static void main(String[] args) { // // Create a VOD instance in the specified region. // // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); // IVodService vodService = VodServiceImpl.getInstance(); // // // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // // vodService.setAccessKey("your ak"); // // vodService.setSecretKey("your sk"); // // String space = "your space name"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试图片", "test", "素材测试，图片文件", Const.CategoryImage, "jpg"); // functionsList.add(addOptionInfo); // // VodStreamUploadRequest vodUploadMaterialRequest = new VodStreamUploadRequest(); // vodUploadMaterialRequest.setSpaceName(space); // vodUploadMaterialRequest.setFileType(Const.FileTypeImage); // vodUploadMaterialRequest.setContent(null); // vodUploadMaterialRequest.setSize(0L); // vodUploadMaterialRequest.setChunkSize(0L); // vodUploadMaterialRequest.setFileName("hello/vod/material.jpeg"); // vodUploadMaterialRequest.setFunctions(JSON.toJSONString(functionsList)); // vodUploadMaterialRequest.setStorageClass(1); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.streamUploadMaterial(vodUploadMaterialRequest); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } //// 字幕素材上传 // public static void main(String[] args) { // // Create a VOD instance in the specified region. // // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); // IVodService vodService = VodServiceImpl.getInstance(); // // // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // // vodService.setAccessKey("your ak"); // // vodService.setSecretKey("your sk"); // // String space = "your space name"; // String filePath = "your file path"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试字幕", "test", "素材测试，字幕文件", Const.CategorySubtitle, "vtt"); // functionsList.add(addOptionInfo); // // FunctionsCaptionInput captionInput = new FunctionsCaptionInput(); // captionInput.setVid("your vid"); // 绑定的视频 Vid // captionInput.setFid("same as vid"); // 与 Vid 保持一致 // captionInput.setLanguage("eng-US"); // 字幕语言 // captionInput.setFormat("webvtt"); // 字幕格式 // captionInput.setTitle("字幕标题"); // 字幕标题 // captionInput.setActionType("upload"); // 操作类型，固定为 upload // captionInput.setAutoPublish(true); // 上传后是否自动发布 // captionInput.setSource("MU"); // 字幕来源，MU 表示 Material Upload // // 调用 CaptionUploadFunction 方法并传入对象 // Functions captionUploadFunction = CaptionUploadFunction(captionInput); // functionsList.add(captionUploadFunction); // // VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() // .setSpaceName(space) // .setFilePath(filePath) // .setFileType(Const.FileTypeObject) // .setFileName("hello/vod/object.vtt") // .setFunctions(JSON.toJSONString(functionsList)) // .build(); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest,null); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } // 字幕素材流上传 // public static void main(String[] args) { // // Create a VOD instance in the specified region. // // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); // IVodService vodService = VodServiceImpl.getInstance(); // // // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // // vodService.setAccessKey("your ak"); // // vodService.setSecretKey("your sk"); // // String space = "your space name"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试字幕", "test", "素材测试，字幕文件", Const.CategorySubtitle, "vtt"); // functionsList.add(addOptionInfo); // // VodStreamUploadRequest vodUploadMaterialRequest = new VodStreamUploadRequest(); // vodUploadMaterialRequest.setSpaceName(space); // vodUploadMaterialRequest.setFileType(Const.FileTypeObject); // vodUploadMaterialRequest.setContent(null); // vodUploadMaterialRequest.setSize(0L); // vodUploadMaterialRequest.setChunkSize(0L); // vodUploadMaterialRequest.setFileName("hello/vod/material.vtt"); // vodUploadMaterialRequest.setFunctions(JSON.toJSONString(functionsList)); // vodUploadMaterialRequest.setStorageClass(1); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.streamUploadMaterial(vodUploadMaterialRequest); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } } ``` ## 进阶功能 ### 展示上传进度条进度条功能用于展示媒资上传进度，您可根据自身业务需求使用进度条功能。进度条功能采用观察者模式，您可以通过实现 `VodUploadProgressListener` 接口中的 `progressChanged()` 方法集成相应的业务逻辑。 :::tip 需使用 Java SDK v1.0.97 或以上版本。 ::: 示例代码如下： ```Java package com.volcengine.helper; // 实现 VodUploadProgressListener 方法展示上传进度条 public class VodUploadMediaProcessListener implements VodUploadProgressListener { /** * 已成功上传总字节数 */ private long bytesUploaded = 0; /** * 原文件大小 */ private long fileSize = -1; // 使用进度条需要您重写回调方法，以下为参考示例 @Override public void progressChanged(VodUploadProgressEvent progressEvent) { long bytes = progressEvent.getByteSize(); VodUploadProgressEventType eventType = progressEvent.getEventType(); switch (eventType) { // 文件大小事件通知。SDK 获得文件大小时会触发该事件，通知文件大小 case FILE_SIZE_EVENT: this.fileSize = bytes; // 业务逻辑 System.out.println("file size is " + this.fileSize); break; // 传输事件通知，每个分片传输完成时会触发该事件，通知写入的分片字节数 case UPLOAD_BYTES_EVENT: this.bytesUploaded += bytes; if (this.bytesUploaded != this.fileSize - 1) { int percent = (int) (this.bytesUploaded * 100.0 / this.fileSize); System.out.println("uploaded " + percent + "%"); } else { int percent = 99; System.out.println("uploaded " + percent + "%"); } // 业务逻辑 break; default: break; } } } ``` ## 后续操作 ### 查看上传结果您可以通过配置上传事件通知及时获取上传的进展和状态，详细介绍请见[上传事件通知](https://www.volcengine.com/docs/4/2887#%E4%B8%8A%E4%BC%A0%E4%BA%8B%E4%BB%B6%E9%80%9A%E7%9F%A5)。 ### 上传后自动转码您可以通过工作流实现上传后自动转码，详细介绍请见[工作流](https://www.volcengine.com/docs/4/65675)。 ### 发布音视频音视频资源上传至视频点播服务之后，默认为**未发布**状态，此时无法获取到播放地址。因此在音视频播放前，您需要先修改音视频状态为**已发布**。具体操作请参见[修改音视频发布状态](https://www.volcengine.com/docs/4/67348)。 ## 常见问题 ### 我在上传过程中通过 `FileName` 参数设置了文件名称，但上传后控制台显示"未命名"，为什么没有显示我设置的文件名称？这是因为在视频点播服务中，`FileName` 参数实际上指的是文件路径（即媒资在存储桶中的唯一标识和存储位置），而不是用户可见的文件名称。如需设置控制台显示的文件名称，您需要通过上传功能函数设置 `FileTitle` 参数。详见[上传功能函数说明](https://www.volcengine.com/docs/4/1185644)。 ### RecordType、FileType、Category 这三个参数的区别及如何设置？ | | | \ |参数 |说明 | |---|---| | | | \ |FileType |* **作用**：在 `ApplyUploadInfo` 接口中指定文件类型，用于分配不同的上传域名。 |\ | |* **取值**： |\ | | * `media`：（默认）音视频文件（如 MP4、MP3）。 |\ | | * `image`：图片文件（如 JPG、PNG）。 |\ | | * `object`：其他类型文件（如字幕、字体）。 | | | | \ |RecordType |* **作用**：在 `CommitUploadInfo` 接口的[上传功能函数](https://www.volcengine.com/docs/4/1185644)中指定媒资类型，决定生成音视频或素材的元数据。 |\ | |* **取值**： |\ | | * `1`：（默认）音视频。 |\ | | * `2`：素材（如图片、字幕、字体等）。 | | | | \ |Category |* **作用**：当 `RecordType` 为 `2`（素材）时，进一步细化素材类型。 |\ | |* **取值**：`video`、`audio`、`image`、`dynamic_img`、`subtitle`、`font` 等。 | 通过正确组合这三个参数，可确保文件上传至正确的域名并生成匹配的元数据。示例： * **上传音视频（如 MP4）** * `FileType` 设为 `media` 或留空。 * `RecordType` 设为 `1` 或留空。 * `Category` 无需设置（仅当 `RecordType=2` 时生效）。 * **上传素材图片（如 JPG）** * `FileType` 设为 `image`（图片使用图片上传域名）。 * `RecordType` 设为 `2`（素材）。 * `Category` 设为 `image`（进一步指定为图片素材）。 * **上传字幕文件（如 SRT）** * `FileType` 设为 `object`（非音视频/图片的文件类型）。 * `RecordType` 设为 `2`（素材）。 * `Category` 设为 `subtitle`（进一步指定为字幕素材）。 :::tip 通过服务端 SDK 上传素材时，接口已默认设置 `RecordType` 为 2，用户无需再设置。 ::: ### 如果我想在上传后对媒资进行分类，该如何操作？视频点播当前仅支持手动分类。您可在[视频点播控制台](https://console.volcengine.com/vod/overview/)指定空间内的**分类管理**页面创建分类并获取分类 ID，具体请见[分类管理](https://www.volcengine.com/docs/4/100669)。 ## 更多示例 ### 签发临时上传 Token 如果您使用客户端上传 SDK 进行上传，您需要在应用服务端通过 AK 和 SK 在本地签出临时上传 Token，不依赖外网。如希望同时生成多个临时上传 Token，您可以循环调用生成方法。更多信息，请见[客户端上传](/docs/4/3151)。 ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.model.sts2.SecurityToken2; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.util.Time; public class GetUploadSts2Demo { public static void main(String[] args) throws Exception { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); //set expire time SecurityToken2 sts2WithExpire = vodService.getUploadSts2WithExpire(Time.Hour); System.out.println(JSON.toJSONString(sts2WithExpire)); //expire after one hour by default SecurityToken2 sts2 = vodService.getUploadSts2(); System.out.println(JSON.toJSONString(sts2)); } } ``` ### 获取上传地址和凭证接口请求参数和返回参数说明详见 [ApplyUploadInfo](https://www.volcengine.com/docs/4/164295)。 ```Java package com.volcengine.example.vod.upload; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; public class VodApplyUploadInfoDemo { public static void main(String[] args) throws Exception { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); try { com.volcengine.service.vod.model.request.VodApplyUploadInfoRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodApplyUploadInfoRequest.newBuilder(); reqBuilder.setSpaceName("your SpaceName"); reqBuilder.setSessionKey("your SessionKey"); reqBuilder.setFileSize(0); reqBuilder.setFileType("your FileType"); reqBuilder.setFileName("your FileName"); reqBuilder.setStorageClass(1); reqBuilder.setFileExtension("your FileExtension"); reqBuilder.setClientNetWorkMode("your ClientNetWorkMode"); reqBuilder.setClientIDCMode("your ClientIDCMode"); reqBuilder.setNeedFallback(false); reqBuilder.setUploadHostPrefer("your UploadHostPrefer"); com.volcengine.service.vod.model.response.VodApplyUploadInfoResponse resp = vodService.applyUploadInfo(reqBuilder.build()); if (resp.getResponseMetadata().hasError()) { System.out.println(resp.getResponseMetadata().getError()); System.exit(-1); } System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询 URL 批量上传任务状态接口请求参数和返回参数说明详见 [QueryUploadTaskInfo](https://www.volcengine.com/docs/4/65622)。 ```Java package com.volcengine.example.vod.upload; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; public class VodQueryUploadTaskInfoDemo { public static void main(String[] args) throws Exception { // Create a VOD instance in the specified region. // IVodService vodService = VodServiceImpl.getInstance("cn-north-1"); IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); try { com.volcengine.service.vod.model.request.VodQueryUploadTaskInfoRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodQueryUploadTaskInfoRequest.newBuilder(); reqBuilder.setJobIds("your JobIds"); com.volcengine.service.vod.model.response.VodQueryUploadTaskInfoResponse resp = vodService.queryUploadTaskInfo(reqBuilder.build()); if (resp.getResponseMetadata().hasError()) { System.out.println(resp.getResponseMetadata().getError()); System.exit(-1); } System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 历史版本 #### 2020-08-01 上传音视频接口请求参数和返回参数说明详见 [ApplyUploadInfo](https://www.volcengine.com/docs/4/2915) 及 [CommitUploadInfo](https://www.volcengine.com/docs/4/2916)。 ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.model.beans.Functions; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.request.VodUploadMediaRequest; import com.volcengine.service.vod.model.response.VodCommitUploadInfoResponse; import java.util.ArrayList; import java.util.List; public class VodUploadMediaDemo { public static void main(String[] args) { IVodService vodService = VodServiceImpl.getInstance(); // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641. // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed. // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account. // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); String space = "your space name"; String filePath = "your file path"; List functionsList = new ArrayList<>(); Functions getMetaFunc = Functions.GetMetaFunction(); functionsList.add(getMetaFunc); Functions snapShotFunc = Functions.SnapShotFunction(2.3); functionsList.add(snapShotFunc); VodUploadMediaRequest vodUploadMediaRequest = VodUploadMediaRequest.newBuilder() .setSpaceName(space) .setFilePath(filePath) .setFileName("hello/vod/video") .setFunctions(JSON.toJSONString(functionsList)) .build(); try { VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMedia(vodUploadMediaRequest); if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); System.exit(-1); } System.out.println(vodCommitUploadInfoResponse.toString()); System.out.println(vodCommitUploadInfoResponse.getResult().getData().getVid()); System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); } catch (Exception e) { e.printStackTrace(); } } } ``` #### 2020-08-01 上传素材接口请求参数和返回参数说明详见 [ApplyUploadInfo](https://www.volcengine.com/docs/4/2915) 及 [CommitUploadInfo](https://www.volcengine.com/docs/4/2916)。 ```Java package com.volcengine.example.vod.upload; import com.alibaba.fastjson.JSON; import com.volcengine.service.vod.Const; import com.volcengine.model.beans.Functions; import com.volcengine.service.vod.IVodService; import com.volcengine.service.vod.impl.VodServiceImpl; import com.volcengine.service.vod.model.request.VodUploadMaterialRequest; import com.volcengine.service.vod.model.response.VodCommitUploadInfoResponse; import java.util.ArrayList; import java.util.List; public class VodUploadMaterialDemo { public static void main(String[] args) { IVodService vodService = VodServiceImpl.getInstance(); // call below method if you dont set ak and sk in ～/.vcloud/config vodService.setAccessKey("your ak"); vodService.setSecretKey("your sk"); String space = "your space name"; String filePath = "your file path"; List functionsList = new ArrayList<>(); Functions getMetaFunc = Functions.GetMetaFunction(); functionsList.add(getMetaFunc); Functions snapShotFunc = Functions.SnapShotFunction(2.3); functionsList.add(snapShotFunc); Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试视频", "test", "素材测试，视频文件", Const.CategoryVideo, "mp4"); functionsList.add(addOptionInfo); VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() .setSpaceName(space) .setFilePath(filePath) .setFileType(Const.FileTypeMedia) .setFunctions(JSON.toJSONString(functionsList)) .build(); try { VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest); if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); System.exit(-1); } System.out.println(vodCommitUploadInfoResponse.toString()); System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); } catch (Exception e) { e.printStackTrace(); } } //// 上传图片素材 // public static void main(String[] args) { // IVodService vodService = VodServiceImpl.getInstance(); // // // call below method if you dont set ak and sk in ～/.vcloud/config // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); // // String space = "your space name"; // String filePath = "your file path"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试图片", "test", "素材测试，图片文件", Const.CategoryImage, "jpg"); // functionsList.add(addOptionInfo); // // VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() // .setSpaceName(space) // .setFilePath(filePath) // .setFileType(Const.FileTypeImage) // .setFileName("hello/vod/image") // .setFunctions(JSON.toJSONString(functionsList)) // .build(); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } //// 上传字幕素材 // public static void main(String[] args) { // IVodService vodService = VodServiceImpl.getInstance(); // // // call below method if you dont set ak and sk in ～/.vcloud/config // vodService.setAccessKey("your ak"); // vodService.setSecretKey("your sk"); // // String space = "your space name"; // String filePath = "your file path"; // // List functionsList = new ArrayList<>(); // Functions getMetaFunc = Functions.GetMetaFunction(); // functionsList.add(getMetaFunc); // // Functions snapShotFunc = Functions.SnapShotFunction(2.3); // functionsList.add(snapShotFunc); // // Functions addOptionInfo = Functions.AddOptionInfoFunction("素材测试字幕", "test", "素材测试，字幕文件", Const.CategorySubtitle, "vtt"); // functionsList.add(addOptionInfo); // // VodUploadMaterialRequest vodUploadMaterialRequest = VodUploadMaterialRequest.newBuilder() // .setSpaceName(space) // .setFilePath(filePath) // .setFileType(Const.FileTypeObject) // .setFileName("hello/vod/object") // .setFunctions(JSON.toJSONString(functionsList)) // .build(); // // try { // VodCommitUploadInfoResponse vodCommitUploadInfoResponse = vodService.uploadMaterial(vodUploadMaterialRequest); // if (vodCommitUploadInfoResponse.getResponseMetadata().hasError()) { // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getError()); // System.exit(-1); // } // System.out.println(vodCommitUploadInfoResponse.toString()); // System.out.println(vodCommitUploadInfoResponse.getResult().getData().getMid()); // System.out.println(vodCommitUploadInfoResponse.getResponseMetadata().getRequestId()); // } catch (Exception e) { // e.printStackTrace(); // } // } } ```