为接入亚太东南（柔佛）地域，播放器 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
      // 建议开发的过程中打开 Xcode 控制台日志，获取更多播放信息
      [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>", // 替换为视频点播控制台“应用管理”中的 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：修改 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:@"YOUR_APP_ID" licenseName:licenseName];
      // 接入海外地域必填；不填写默认华北
      configuration.appRegion = TTSDKServiceVendorMYA;
      [TTSDKManager startWithConfiguration:configuration];
  }
  

• 设置上传海外参数：

  BDVideoUploaderClient *videoUploadClient = [[BDVideoUploaderClient alloc] initWithFilePath:@"YOUR_FILE_PATH"];
  [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: '<YOUR_USER_ID>', // 替换为业务自行定义的用户标识
      appId: '<YOUR_APP_ID>', // 替换为视频点播控制台“应用管理”中的 App ID
      // ...
      region: 'ap-southeast-1',   // 默认为华北 'cn-north-1'，柔佛需要设置为 'ap-southeast-1'
      videoConfig: {
          spaceName: '<YOUR_SPACE_NAME>', // 替换为视频点播控制台创建的上传空间名称
      },
  }
  vodUploader = new TTUploader(initConfig)
  vodUploader.start()