本文介绍视频点播的服务地域及各地域的功能支持情况、计费说明和接入说明。

注意事项

在跨境传输的场景中，对于媒资上传模块，当从国内上传媒资到海外亚太东南（柔佛）地域时，传输效果可能会受网络质量影响。

功能支持

费用说明

下表为您介绍不同服务地域的价格，国内其他计费价格详见按量计费。

接入说明

OpenAPI

API 列表

详见 API 列表

接入地域

下表为不同地域对应的服务地址。

地域参数

对于数据统计模块的 API，查询服务在国内，所以新增地域参数 RegionList 来筛选不同地域的数据：

服务端 SDK

使用视频点播服务端 SDK 时，不同地域在初始化时需要传入不同的地域参数。具体说明如下。

Golang

调用 NewInstanceWithRegion 方法初始化 Instance，传入 Region 。Region 为可选值，不传则默认为 cn-north-1。如果需要同时访问两个不同地域的 API ，则需要初始化两个 Instance。

instance2 := vod.NewInstanceWithRegion(base.RegionCnNorth1) // 华北
instance1 := vod.NewInstanceWithRegion(base.RegionSouthEast1) // 亚太东南（柔佛）

Java

调用 getInstance(String region) 方法初始化 Instance，传入 Region 。Region 为可选值，不传则默认为 cn-north-1。如果需要同时访问两个不同地域的 API ，则需要初始化两个 Instance。

IVodService vodService2 = VodServiceImpl.getInstance(com.volcengine.helper.Const.REGION_CN_NORTH_1); // 华北

IVodService vodService1 = VodServiceImpl.getInstance(com.volcengine.helper.Const.REGION_AP_SOUTHEAST_1);  // 亚太东南（柔佛）

PHP

调用 getInstance(String region) 方法初始化 Client，传入 Region 。Region 为可选值，不传则默认为 cn-north-1。如果需要同时访问两个不同地域的 API ，则需要初始化两个 Client。

$client2 = Volc\Service\Vod\Vod::getInstance('cn-north-1'); // 华北
$client1 = Volc\Service\Vod\Vod::getInstance('ap-southeast-1');  // 亚太东南（柔佛）

Python

调用 VodService(region) 方法初始化 Client，传入 Region。Region 为可选值，不传则默认为 cn-north-1。如果需要同时访问两个不同地域的 API ，则需要初始化两个 Client。

vod_service1 = VodService('cn-north-1')    # 华北
vod_service2 = VodService('ap-southeast-1')  # 亚太东南（柔佛）

点播 SDK

Android

• 集成 SDK： 不同地域的集成方法不同，区别如下，其他具体的内容请详见集成准备。

  • 华北

    def ttsdk_version = xxx; // TTSDK 版本号
    implementation "com.bytedanceapi:ttsdk-player_premium:$ttsdk_version"
    
    // 1.40.2.8 之前的版本还需要添加以下 AppLog 依赖，用于上报日志
    implementation "com.bytedance.applog:RangersAppLog-Lite-cn:6.15.4"
    

  • 亚太东南（柔佛）

    说明

    需移除默认依赖的国内版 AppLog，更换为依赖海外版本，例如 6.15.4。

    def ttsdk_version = xxx; //  海外版本号 1.40.3.103
    def applog_version = xxx;  // 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：在初始化 SDK 时需传入具体地域。示例代码如下：

  // 华北
  String appRegion = AppRegion.CHINA;
  
  // 亚太东南（柔佛）
  String appRegion = AppRegion.MYA;
  
  Env.init(new Config.Builder()
          .setAppRegion(appRegion)
           // ...
          .build());
  

iOS

• 集成 SDK： 使用海外版本亚太东南（柔佛）集成方法有所不同，其他具体的内容请详见集成准备。

  说明

  修改 podfile 文件默认依赖 AppLog 版本更换为海外版本。例如，6.16.2。

  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
    # 推荐使用最新稳定版，版本信息见「获取 SDK 最新版本号」小节
    pod 'TTSDKFramework', '1.40.3.100-premium', :subspecs => ['Player-SR']
     
    # TTSDKFramework 默认依赖 RangersAppLog 版本为国内版本  
    # 通过如下方式，可以自定义使用 RangersAppLog 版本
    # DoNotInstallApplogVersion 定义在 TTSDKFramework.podspec 文件中
    # 随着 TTSDKFramework 升级 DoNotInstallApplogVersion 值会有变化
    # 业务可以参考 TTSDKFramework.podspec 定义值自行修改
    $DoNotInstallApplogVersion = '6.16.2'
    pod 'RangersAppLog', '6.16.2', :subspecs => ['Core', 'Host/SG']  
   
  end
  

• 使用 SDK：在初始化 SDK 时需传入具体地域。示例代码如下：

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
      // 初始化 TTSDK
      [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.40.3.100-premium 版本支持该参数；使用海外版本必填；不填写默认华北
      
      // 设置最大缓存 Size，默认 100M，可根据自身业务场景调整，超过缓存大小按照 LRU 规则清理
      TTSDKVodConfiguration *vodConfig = [[TTSDKVodConfiguration alloc] init];
      vodConfig.cacheMaxSize = 300 * 1024 *1024; // 建议设置大小 300M
      configuration.vodConfiguration = vodConfig;
  
      [TTSDKManager startWithConfiguration:configuration]; 
  }
  

Web

• 集成 SDK：不同地域的集成 SDK 的引入依赖有所不同，其他具体的内容请详见集成 SDK。

  • UMD 引入：请您在本地的项目工程内新建 index.html 文件，在 HTML 页面内引入 VePlayer 的样式文件和脚本文件。代码如下所示。

    • 华北

      <link rel="stylesheet" href="https://lf-unpkg.volccdn.com/obj/vcloudfe/sdk/@volcengine/veplayer/1.8.1/index.min.css"/>
      <script src="https://lf-unpkg.volccdn.com/obj/vcloudfe/sdk/@volcengine/veplayer/1.8.1/index.min.js"></script>
      

    • 亚太东南（柔佛）

      <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 参数，支持访问国内外的数据。

  参数名	类型	默认值	描述
  region	String	cn	服务地域。取值如下： cn： 华北。 mya： 亚太东南（柔佛）。

  新增如下实例化属性：

  参数名	类型	读写类型	默认值	描述
  region	String	可读可写	cn	服务地域。取值如下： cn： 华北。 mya： 亚太东南（柔佛）。

  以 HLS 标准加密播放为例，实例化时设置 region 为 mya，具体代码示例如下：

  var playerSdk = new VePlayer({
          id: 'mse',
          width: 640,
          height: 360,
          region:  '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

Android

• 集成 SDK：移除默认依赖的国内版 AppLog，更换为依赖海外版本。

  //  接入亚太东南（柔佛）地域需集成 1.43.1.5 或以上版本
  def ttsdk_version = xxx;
  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 时需传入具体地域：

  // 华北
  // 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");
  

iOS

• 集成 SDK：修改 podfile 文件，移除默认依赖的 AppLog 版本，更换为海外版本。

  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 默认依赖 RangersAppLog 版本为国内版本 
    # 通过如下方式，可以自定义使用 RangersAppLog 版本
    # DoNotInstallApplogVersion 定义在 TTSDKFramework.podspec 文件中
    # 随着 TTSDKFramework 升级 DoNotInstallApplogVersion 值会有变化
    # 您可以参考 TTSDKFramework.podspec 定义值自行修改
    $DoNotInstallApplogVersion = '6.16.2'
    pod 'RangersAppLog', '6.16.2', :subspecs => ['Core', 'Host/SG']  
   
  end
  

• 初始化 SDK 时传入具体地域：

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
      // 初始化 TTSDK
      [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"];
  

Web

• 集成 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()