React Native 播放器 SDK 是基于 Android 和 iOS 播放器 SDK 的统一封装，以便开发者在 React Native 开发环境下快速高效地集成 Android 和 iOS 播放器 SDK。本文为您介绍集成 React Native 播放器 SDK 的环境要求和具体操作步骤。

开发环境 #

• React Native 版本：支持 0.70 及以上版本
• Node 版本：推荐 18.0 及以上版本
• 系统版本：
  • iOS：iOS 12.4 或以上版本的 iOS 设备
  • Android：minSdkVersion: 23
• 开发工具：推荐使用 Visual Studio Code 或 Android Studio

获取 License #

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成创建应用、申请免费测试 License、绑定 License 与应用，详细操作步骤，请见应用管理和播放器 License。

集成步骤 #

步骤 1：添加依赖 #

在 React Native 项目根目录中执行如下命令添加 SDK 依赖：

yarn add @volcengine/react-native-vod-player

步骤 2：平台配置 #

为 Android 和 iOS 分别进行相应配置：

Android

1. 在 React Native 项目 android 文件夹下的 build.gradle 文件中的 repositories 中配置 mavenCentral() 和火山引擎 maven 服务：

   allprojects {
       repositories {
           google()
           jcenter()
           mavenCentral()
           maven {
               url "https://artifact.bytedance.com/repository/Volcengine/" // volc public maven repo
           }
       }
   }
   

2. 此外，您还需添加 Java 8 支持、权限声明和混淆规则，具体请参考 Android SDK 集成文档。

iOS

1. 在 React Native 项目的 ios 文件夹下的 Podfile 文件中配置 Pod Source：

   source 'https://github.com/CocoaPods/Specs.git'
   source 'https://github.com/volcengine/volcengine-specs.git'
   

2. 关闭 Bitcode，具体请参考 iOS SDK 集成文档。

步骤 3：添加 License 文件 #

复制您获取到的 License 文件后，分别添加至您 React Native 工程的 Android 和 iOS 文件夹下。

• Android：放置于 android/app/src/main/assets 下。如果没有 assets 文件夹，您可自行创建。
• iOS：通过 Xcode 的 Add Files to 按钮添加至 iOS/DemoApp 下，如下图所示。DemoApp 为项目名称，您可根据实际项目名称修改。
  

后续在初始化 SDK 时，您还需要传入 License 文件路径。

后续操作 #

至此，您已完成播放器 SDK 的集成。下面演示如何使用播放器 SDK 播放视频。详情请见基础功能。

常见问题 #

我的视频存储在视频点播的海外柔佛地域，需要特殊配置吗？ #

当您的业务接入海外柔佛地域时，需要对播放器 SDK 进行专门的地域配置，主要涉及以下两个环节：

• 配置海外日志上报通道：根据您应用的目标平台，分别为 Android 和 iOS 配置使用海外专用的日志上报依赖库。
• 指定海外业务服务地域：在初始化 SDK 时，通过 appRegion 参数，明确指定视频资源所在的海外服务地域。

详细的操作步骤，请参见服务地域文档中的播放器 SDK章节。