本文介绍视频点播的服务地域及各地域的功能支持情况、计费说明和接入说明。
说明
视频点播亚太东南(柔佛)地域邀测中,仅针对企业用户开放。如您有相关需求,请联系您的商务经理申请开通。
注意事项
在跨境传输的场景中,对于媒资上传模块,当从国内上传媒资到海外亚太东南(柔佛)地域时,传输效果可能会受网络质量影响。
功能支持
功能 | 子功能 | 华北 | 亚太东南(柔佛) |
---|
媒资管理 | 视频管理 | ✔️ | ✔️ |
素材管理 | ✔️ | ✔️ |
存储类型 | ✔️ | ✔️ |
媒资存储策略 | ✔️ | ❌ |
媒体处理 | 视频转码模板 | ✔️ | ✔️ |
极智超清模板 | ✔️ | ✔️ |
音频转码模板 | ✔️ | ✔️ |
截图模板 | ✔️ | ✔️ |
水印贴片模板 | ✔️ | ✔️ |
闲时转码 | ✔️ | ❌ |
低成本转码 | ✔️ | ❌ |
倍速转码 | ✔️ | ✔️ |
自定义转码组 | ✔️ | ❌ |
画质增强模板 | ✔️ | ❌ |
检测修复模板 | ✔️ | ❌ |
多媒体 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.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 = @"you 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.8.1 及之后版本。参见发布历史获取 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.8.1/index.min.js"></script>
初始化 SDK:设置 options
中的 region
参数。
var playerSdk = new VePlayer({
id: 'mse',
width: 640,
height: 360,
region: '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:请参考 Android 和 iOS SDK 接入亚太东南(柔佛)地域的方式,将 SDK 默认依赖的 AppLog 版本更换为海外版本。
- 初始化 SDK:设置
region
参数指定地域。TTSDKVodConfiguration vodConfig = TTSDKVodConfiguration();
vodConfig.cacheMaxSize = 300 * 1024 * 1024;
TTSDKConfiguration sdkConfig = TTSDKConfiguration.defaultConfigurationWithAppIDAndLicPath(
appID: "xxx", licenseFilePath: "xxx", channel: "xxx");
sdkConfig.vodConfiguration = vodConfig;
sdkConfig.appName = "xxx";
sdkConfig.appVersion = "xxx";
sdkConfig.appRegion = TTSDKServiceVendorMYA; // 接入海外地域必填;不填写默认华北
FlutterTTSDKManager.startWithConfiguration(sdkConfig);
上传 SDK
为接入亚太东南(柔佛)地域,上传 SDK 的以下使用步骤与华北地域存在区别:
集成 SDK:移除 SDK 默认依赖的国内版 AppLog,更换为依赖海外版本,如 6.15.4。
说明
接入亚太东南(柔佛)地域需集成 1.43.1 及之后版本。参见发布历史获取 SDK 最新版本号。
def ttsdk_version = xxx; // 将 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 = xxx; // 设置 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();
// 创建上传的实例之后设置
mUpload.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()