本文介绍视频点播的服务地域及各地域的功能支持情况、计费说明和接入说明。
注意事项
在跨境传输的场景中,对于媒资上传模块,当从国内上传媒资到海外亚太东南(柔佛)地域时,传输效果可能会受网络质量影响。
功能支持
功能 | 子功能 | 华北 | 亚太东南(柔佛) |
|---|
媒资管理 | 视频管理 | ✔️ | ✔️ |
素材管理 | ✔️ | ✔️ |
存储类型 | ✔️ | ✔️ |
媒资存储策略 | ✔️ | ❌ |
媒体处理 | 视频转码模板 | ✔️ | ✔️ |
极智超清模板 | ✔️ | ✔️ |
音频转码模板 | ✔️ | ✔️ |
自适应码流模板 | ✔️ | ✔️ |
截图模板 | ✔️ | ✔️ |
水印贴片模板 | ✔️ | ✔️ |
闲时转码 | ✔️ | ❌ |
低成本转码 | ✔️ | ❌ |
倍速转码 | ✔️ | ✔️ |
自定义转码组 | ✔️ | ❌ |
画质增强模板 | ✔️ | ✔️ 注意 此为白名单功能。如需开通,请提交工单联系火山引擎技术支持团队。 |
检测修复模板 | ✔️ | ❌ |
多媒体 AI 模板 | ✔️ | ❌ |
字幕模板 | ✔️ | ✔️ |
工作流 | ✔️ | 支持添加视频转码、音频转码、极智超清、自适应码流、画质增强、截图、智能字幕、自动发布、暗水印提取任务 |
智能转码策略 | ✔️ | ❌ |
分发加速 | 域名管理 | ✔️ | ✔️ |
域名设置 | ✔️ | ✔️ |
刷新预热 | ✔️ | ✔️ |
视频剪辑 | N/A | ✔️ | ❌ |
空间设置 | 上传存储设置 | ✔️ | ✔️ 注意 暂不支持自动生成候选封面、上传完成回调返回工作流任务 ID 和外网访问设置。 |
回源设置 | ✔️ | ❌ |
同步设置 | ✔️ | ❌ |
分类管理 | ✔️ | ✔️ |
回调设置 | ✔️ | ✔️ |
播放器 SDK | 应用管理 | ✔️ | ✔️ |
License 管理 | ✔️ | ✔️ |
数据统计 | 用量查询 | ✔️ | 仅支持查看带宽流量、媒资管理、转码、截图、智能字幕用量 |
源站统计 | ✔️ | ✔️ |
分发统计 | ✔️ | ✔️ |
播放统计 | ✔️ | 仅支持查看播放时长、播放用户数 |
质量平台 | N/A | ✔️ | ✔️ |
日志管理 | 离线日志下载 | ✔️ | ✔️ |
实时日志投递 | ✔️ | ❌ |
常用工具 | IP 归属查询 | ✔️ | ✔️ |
数据迁移 | ✔️ | ✔️ |
签名工具 | ✔️ | ✔️ |
注意
数据统计、应用管理和 License 管理页面不支持在顶部导航栏切换地域。您可通过页面中的选择器筛选地域。
费用说明
亚太东南(柔佛)地域计费详见按量计费。
接入说明
OpenAPI
API 列表
详见 API 列表
接入地域
下表为不同地域对应的服务地址。
地域名称 | 地域 ID | 接入地址 |
|---|
华北 | cn-north-1
| vod.volcengineapi.com
|
亚太东南(柔佛) | ap-southeast-1
| vod.ap-southeast-1.volcengineapi.com
|
地域参数
对于数据统计模块的 API,查询服务在国内,所以新增地域参数 RegionList 来筛选不同地域的数据:
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|
RegionList | String | 否 | cn-north-1
| 地域。多个用英文逗号 , 连接。取值如下: cn-north-1:华北ap-southeast-1:亚太东南(柔佛)
说明 如果是 POST 请求类型为 Array of String。 |
服务端 SDK
使用视频点播服务端 SDK 时,不同地域在初始化时需要传入不同的地域参数。具体请见以下文档:
播放器 SDK
为接入亚太东南(柔佛)地域,播放器 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:移除 SDK 默认依赖的国内版 AppLog,更换为依赖海外版本,如 6.15.4。
说明
接入亚太东南(柔佛)地域需集成 1.41.1 及之后版本。参见发布历史获取 SDK 最新版本号。
def ttsdk_version = "x.x.x.x" // 替换成实际 SDK 版本号,如 "1.41.1.8"
def applog_version = "6.15.4" // 设置 AppLog 版本号为 "6.15.4"
implementation ("com.bytedanceapi:ttsdk-player_premium:$ttsdk_version") {
exclude group: 'com.bytedance.applog', module: 'RangersAppLog-Lite-cn'
}
implementation "com.bytedance.applog:RangersAppLog-Lite-global:$applog_version"
初始化 SDK:设置 Region 参数指定地域。
// 华北
// String appRegion = AppRegion.CHINA;
// 亚太东南(柔佛)
String appRegion = AppRegion.MYA;
Env.init(new Config.Builder()
.setAppRegion(appRegion)
// ...
.build());
为接入亚太东南(柔佛)地域,播放器 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:修改 podfile 文件,将 SDK 默认依赖的 AppLog 版本更换为海外版本,如 6.16.2。
说明
接入亚太东南(柔佛)地域需集成 1.41.1 及之后版本。参见发布历史获取 SDK 最新版本号。
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'
platform :ios, '11'
target 'VOLCDemo' do
# 添加 TTSDKFramework 动态库并指定 subspecs 为 Player-SR
# 推荐使用最新稳定版
pod 'TTSDKFramework', '1.41.1.8-premium', :subspecs => ['Player-SR']
# TTSDKFramework 默认依赖 AppLog 版本为国内版本
# 通过如下方式,可以自定义使用 AppLog 版本
# DoNotInstallApplogVersion 定义在 TTSDKFramework.podspec 文件中
# 随着 TTSDKFramework 升级 DoNotInstallApplogVersion 值会有变化
# 业务可以参考 TTSDKFramework.podspec 定义值自行修改
$DoNotInstallApplogVersion = '6.16.2'
pod 'RangersAppLog', '6.16.2', :subspecs => ['Core', 'Host/SG']
end
初始化 SDK:设置 Region 参数指定地域。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 初始化 SDK
[self initTTSDK];
return YES;
}
- (void)initTTSDK {
#ifdef DEBUG
// 建议开发的过程中打开 logcat 日志,获取更多播放信息
[TTVideoEngine setLogFlag:TTVideoEngineLogFlagAll];
#endif
// 请在火山引擎点播后台申请的 AppID
NSString *appId = @"Your_App_Id";
// 请将火山引擎点播后台申请的 License 拖动到主工程目录下
// 请务必将 “ttlicense.lic” 名字换成实际 License 文件名字
NSString *licenseName = @"ttlicense.lic";
TTSDKConfiguration *configuration = [TTSDKConfiguration defaultConfigurationWithAppID:appId licenseName:licenseName];
configuration.appRegion = TTSDKServiceVendorMYA; // 从 1.41.1.8 版本支持该参数;接入海外地域必填;不填写默认华北
// 设置最大缓存 Size,默认 100M,可根据自身业务场景调整,超过缓存大小按照 LRU 规则清理
TTSDKVodConfiguration *vodConfig = [[TTSDKVodConfiguration alloc] init];
vodConfig.cacheMaxSize = 300 * 1024 *1024; // 建议设置大小 300M
configuration.vodConfiguration = vodConfig;
[TTSDKManager startWithConfiguration:configuration];
}
为接入亚太东南(柔佛)地域,播放器 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:在本地的项目工程内新建 index.html 文件,在 HTML 页面内引入 VePlayer 的样式文件和脚本文件。
说明
接入亚太东南(柔佛)地域推荐集成 1.14.0 及之后版本。参见发布历史获取 SDK 最新版本号。
<link rel="stylesheet" href="https://sf-unpkg.bytepluscdn.com/obj/byteplusfe-sg/sdk/@volcengine/veplayer/1.8.1/index.min.css"/>
<script src="https://sf-unpkg.bytepluscdn.com/obj/byteplusfe-sg/sdk/@volcengine/veplayer/1.14.0/index.min.js"></script>
初始化 SDK:设置 options 中的 region 参数。
const playerSdk = new VePlayer({
id: 'mse',
width: 640,
height: 360,
region: 'mya', // 服务地域,与媒资所存储的地域保持一致,取值:cn: 华北; mya: 亚太东南(柔佛)
userRegion: 'mya', // 终端用户所在地域,影响日志请求的上报服务及动态依赖拉取的域名, 取值:cn: 国内; mya: 海外
url: 'https://voddemo.video.com/encrypt-demo.m3u8',
EncryptHlsPlugin: {
keyToken: 'keyToken', // 更换为实际的 keyToken
},
vodLogOpts: {
vtype: 'HLS',
drm_type: 1,
tag: '普通视频',
line_app_id: xxxx, // 更换为您自己的 appid
line_user_id: 'veplayer_web_demo'
}
});
为接入亚太东南(柔佛)地域,播放器 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:在您项目根目录的 pubspec.yaml 文件中,为 ve_vod 插件增加 use_global_app_log: true 的配置,以配置海外日志上报通道。
说明
接入亚太东南(柔佛)地域推荐集成 1.49.10 及之后版本。参见发布历史获取 SDK 最新版本号。
ve_vod:
# sub_spec: premium 根据您的 License 类型配置
sub_spec: premium
# 开启海外日志上报通道
use_global_app_log: true
初始化 SDK:通过 sdkConfig.appRegion 参数,明确指定视频资源所在的海外服务地域。
TTSDKVodConfiguration vodConfig = TTSDKVodConfiguration();
vodConfig.cacheMaxSize = 300 * 1024 * 1024;
TTSDKConfiguration sdkConfig = TTSDKConfiguration.defaultConfigurationWithAppIDAndLicPath(
appID: "Your_App_Id",
licenseFilePath: "Your_License_File_Path",
channel: "Your_Channel");
sdkConfig.vodConfiguration = vodConfig;
sdkConfig.appName = "Your_App_Name";
sdkConfig.appVersion = "Your_App_Version";
sdkConfig.appRegion = TTSDKServiceVendor.TTSDKServiceVendorMYA; // 接入海外地域必填;不填写默认华北
FlutterTTSDKManager.startWithConfiguration(sdkConfig);
为接入亚太东南(柔佛)地域,播放器 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:
Android:在项目 android/gradle.properties 文件中添加变量 USE_GLOBAL_RANGERS_APP_LOG=true。
# android/gradle.properties
# 添加此属性以启用海外版本 AppLog
USE_GLOBAL_RANGERS_APP_LOG=true
iOS:在项目 ios 文件夹下的 Podfile 文件中将 AppLog 版本更换为海外版本,如 6.16.8。
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'
platform :ios, '11'
target 'VOLCDemo' do
# TTSDKFramework 默认依赖 AppLog 版本为国内版本
# 通过如下方式,可以自定义使用 AppLog 版本
# DoNotInstallApplogVersion 定义在 TTSDKFramework.podspec 文件中
# 随着 TTSDKFramework 升级 DoNotInstallApplogVersion 值会有变化
# 业务可以参考 TTSDKFramework.podspec 定义值自行修改
$DoNotInstallApplogVersion = '6.16.8'
pod 'RangersAppLog', '6.16.8', :subspecs => ['Core', 'Host/SG']
end
初始化 SDK:设置 AppRegion 参数指定地域为'MYA'。
import { initEnv } from '@volcengine/react-native-vod-player';
import {Platform} from 'react-native';
initEnv({
AppID: xxx, // 应用 ID,可在视频点播控制台应用管理页面获取。详见[创建应用](https://www.volcengine.com/docs/4/79594)
AppName: 'democeshi', // 应用英文名,可在视频点播控制台应用管理页面获取。详见[创建应用](https://www.volcengine.com/docs/4/79594)
PackageName: 'com.xxx.xxxx', // Android 项目包名,对应 build.gradle 中的applicationId 的值
BundleID: 'com.xxx.xxxx.x', // iOS 项目包名,对应 Xcode 中 TARGETS 下 Bundle Identifier 的值
AppChannel: Platform.select({
android: 'GoogleStore',
ios: 'AppStore',
}), // 渠道号。由您自定义,如小米应用商店 (xiaomi)、华为应用市场 (huawei) 等
AppVersion: '1.0.0', // App 版本号。合法版本号应包含大于或等于 2 个 . 分隔符,如 "1.3.2"。
AppRegion: 'MYA', // 接入亚太东南(柔佛)地域必填;不填写默认华北
LicenseUri: Platform.select({
android: 'assets:///VeVod.lic',
ios: 'VeVod.lic',
}), // License 文件路径,注意 iOS 和 Android 在各自的文件夹下,通常路径不同
UserUniqueID: 'ReactNativeExample', // 用户 ID,由您自定义,可用于在视频点播控制台单点追查页面查看单设备的播放数据。详见[单点追查](https://www.volcengine.com/docs/4/106093)
OpenLog: true, // 是否开启日志打印。Android 可以通过 logcat 捕获日志;iOS 可以通过 Xcode 捕获日志。
MaxCacheSize: 300 * 1024 * 1024, // 最大缓存,单位 byte
})
上传 SDK
为接入亚太东南(柔佛)地域,上传 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:移除 SDK 默认依赖的国内版 AppLog,更换为依赖海外版本,如 6.15.4。
说明
接入亚太东南(柔佛)地域需集成 1.43.1 及之后版本。参见发布历史获取 SDK 最新版本号。
def ttsdk_version = "x.x.x.x" // 替换成实际 SDK 版本号,如 "1.43.1.5"
implementation ("com.bytedanceapi:ttsdk-ttuploader:$ttsdk_version") {
exclude group: 'com.bytedance.applog', module: 'RangersAppLog-Lite-cn'
}
def applog_version = "6.15.4" // 设置 AppLog 版本号为 "6.15.4"
implementation "com.bytedance.applog:RangersAppLog-Lite-global:$applog_version"
初始化 SDK:设置 Region 参数指定地域。
// 华北
// String appRegion = AppRegion.CHINA;
// 亚太东南(柔佛)
String appRegion = AppRegion.MYA;
Env.init(new Config.Builder()
.setAppRegion(appRegion)
// ...
.build());
设置上传海外参数:
// 设置上传海外 region
BDVideoUploader mUploader = new BDVideoUploader();
// 创建上传的实例之后设置
mUploader.setStringValue(KeyIsSetRegionName, "ap-southeast-1");
mUploader.setUploadDomain("vod.ap-southeast-1.volcengineapi.com");
为接入亚太东南(柔佛)地域,上传 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:修改 podfile 文件,将 SDK 默认依赖的 AppLog 版本更换为海外版本,如 6.16.2。
说明
接入亚太东南(柔佛)地域需集成 1.43.1.9 及之后版本。参见发布历史获取 SDK 最新版本号。
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'
platform :ios, '11'
target 'VOLCDemo' do
# 添加 TTSDKFramework 动态库并指定 subspecs 为 Uploader
# 接入亚太东南(柔佛)地域需集成 1.43.1.9 或以上版本
pod 'TTSDKFramework', '1.43.1.9-premium', :subspecs => ['Uploader']
# TTSDKFramework 默认依赖 AppLog 版本为国内版本
# 通过如下方式,可以自定义使用 AppLog 版本
# DoNotInstallApplogVersion 定义在 TTSDKFramework.podspec 文件中
# 随着 TTSDKFramework 升级 DoNotInstallApplogVersion 值会有变化
# 您可以参考 TTSDKFramework.podspec 定义值自行修改
$DoNotInstallApplogVersion = '6.16.2'
pod 'RangersAppLog', '6.16.2', :subspecs => ['Core', 'Host/SG']
end
初始化 SDK:设置 Region 参数指定地域。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 初始化 SDK
[self initTTSDK];
return YES;
}
- (void)initTTSDK {
// 开启上传模块调试日志,建议 Debug 阶段保持开启,便于排查问题
#if DEBUG
[[BDUploadUtilTool sharedInstance] enableNativeLogFunc:YES];
#endif
// 登录视频点播控制台,获取 AppID
// NSString *appId = @"you app id";
// 注意,如果需要集成 TTSDK 其他模块,请设置 licenseName。
// 如果没有,则 licenseName 参数可以移除。
TTSDKConfiguration *configuration = [TTSDKConfiguration defaultConfigurationWithAppID:<#appid#> licenseName:licenseName];
// 接入海外地域必填;不填写默认华北
configuration.appRegion = TTSDKServiceVendorMYA;
[TTSDKManager startWithConfiguration:configuration];
}
设置上传海外参数:
BDVideoUploaderClient *videoUploadClient = [[BDVideoUploaderClient alloc] initWithFilePath:<#filepath#>];
[videoUploadClient setVideoHostName:@"vod.ap-southeast-1.volcengineapi.com"];
[videoUploadClient setVideoRegionName:@"ap-southeast-1"];
为接入亚太东南(柔佛)地域,上传 SDK 的以下使用步骤与华北地域存在区别:
- 集成 SDK:接入亚太东南(柔佛)地域需集成 1.3.6 或以上版本。
- 初始化 SDK:将
initConfig 中的 Region 参数设为 ap-southeast-1。const initConfig = {
userId: 'XXX',
appId: 'XXX',
// ...
region: 'XXX', // 默认为华北 'cn-north-1',柔佛为 'ap-southeast-1'
videoConfig: {
spaceName: 'XXX',
},
}
vodUploader = new TTUploader(initConfig)
vodUploader.start()