You need to enable JavaScript to run this app.
导航
集成 SDK
最近更新时间:2024.11.05 20:29:55首次发布时间:2024.09.10 17:39:24

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

环境要求

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

前提条件

集成 SDK 前,您需要登录视频点播控制台,完成以下操作:

  • 创建应用
  • 购买 License
  • 绑定 License 与应用
  • 下载 License 文件

详情请见创建应用License 包管理

注意

测试版 License 不能在线上业务 App 使用,原因如下:

  • 测试版 License 仅供联调测试,到期后无法续期。
  • 测试版 License 到期会导致 App 鉴权不通过,从而影响业务使用。

操作步骤

添加依赖

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

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

平台配置

为 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 集成文档

添加 License 文件

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

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

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

注意

工程的 Bundle ID、Package ID 和 App ID 需要与您在视频点播控制台申请 License 时传入的保持一致,否则会出现鉴权失败问题。

后续操作

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