集成 SDK

更新时间: 2022/09/13 09:08:38

本文介绍集成播放器 SDK 的方法。

开发环境要求

在开始运行示例项目之前,请确保开发环境满足以下要求:

环境要求 说明
iOS 版本 9.0 及以上
CPU 架构 ARM 64、ARM V7、x86_6(目前暂不支持 i386 架构)
IDE XCode
其他 安装 CocoaPods。

目录结构

您需要将播放器 SDK 集成到应用中,包括静态库文件和相关的头文件。如下图所示。

播放器集成架构图.png

播放器 SDK 提供两个 ZIP 包,分别是 NELivePlayer_Demo_Android_vx.x.xLivePlayer_Android_SDK_vx.x.x,两个 zip 包的用途和目录说明如下:

  • LivePlayer_iOS_Demo_vx.x.x

    里面包含一个示例工程,为了方便开发时更加简单方便的使用播放器 SDK。Demo 中通过 NELivePlayerViewController 来调用相关接口来实现音视频播放。

  • LivePlayer_iOS_SDK_vx.x.x:

    存放播放器 SDK 的静态库文件和头文件,包括真机版本和模拟器(x86_64)版本,文件说明如下表所示。

    Framework 说明 是否必须
    NMCBasicModuleFramework.framework 基础库 必须
    NELivePlayerFramework.framework 播放器引擎 必须
    NERtd.framework 低延时直播的播放器引擎 必须
    NELPGslb.framework 直播点播调度引擎 必须

    不同播放器版本的 Framework 库文件有差异,具体以实际的库文件为准。

集成SDK

步骤1 集成准备

  1. 创建ViewController,如下图所示。

pic

  1. Subclass of 选择 UIViewController,如下图所示。

pic

步骤2 快速集成

方法 1(推荐):通过 CocoaPods导入

  1. 安装 CocoaPods。

    在终端窗口执行如下命令安装 CocoaPods。

    sudo gem install cocoapods
    
  2. 创建 Podfile 文件。

    在终端窗口,通过 cd 命令进入项目根目录,执行如下命令,项目路径下会展示新创建的 Podfile 文件。

    pod init
    
  3. 执行如下命令搜索资源。

    pod search NELivePlayer
    

    如果搜索不到,请执行如下命令清除搜索列表缓存。

    rm ~/Library/Caches/CocoaPods/search_index.json
    
  4. Podfile 文件中增加类似如下代码,添加依赖。

    pod 'NELivePlayer', '~> 3.1.2'
    
    • 3.1.2 为播放器的版本号,请根据您的需要替换为对应的版本号。
    • 访问网易云信 SDK 下载中心获取播放器最新的版本号。
  5. 执行如下命令安装 SDK。

    pod install
    

    如果无法安装播放器最新版本,请执行如下命令更新本地仓库。

    pod repo update
    

方法 2 :手动导入库文件

  1. 下载最新版的播放器SDK,解压缩到本地。

  2. 将 SDK 中的 framework 导入到 App 工程。

    1. 在 Xcode 左侧的TARGETS 中选择目标项目,例如 NELivePlayerDemo,在顶部导航栏单击 Build Phrases 页签。
    2. Link Binary with Libraries 区域,单击底下的 + 号图标,添加如下Frameworks:
      • NMCBasicModuleFramework.framework
      • NELivePlayerFramework.framework
      • NERtd.framework
      • NELPGslb.framework

    导入Framework.png

    不同播放器版本的 Framework 库文件有差异,具体以实际的库文件为准。

    1. 在顶部单击 General页签,在 Frameworks,Libraries,and Embedded Content 区域, 查看添加的Frameworks。并将 Embed 设置为 Embed & Sign

    集成SDK-iOS.png

  3. 添加播放器 SDK 到 App 工程。

    在 Xcode 左侧的TARGETS 中选择目标项目,例如 NELivePlayerDemo, 在顶部导航栏单击 Build Settings 页签,在 Search Paths > Framework Search Paths 中选择播放器的 Frameworks 所在路径,具体如下图所示。

    添加播放器SDK到App工程.png

步骤3 在项目中导入 SDK

在项目需要使用 SDK API 的文件里,导入头文件。

#import <NELivePlayerFramework/NELivePlayerFramework.h>

常见问题

直接集成 Framework 的时候,如果打包遇到下图的问题,请按照以下方法处理:

webdoc_vod_ios_player_ios_4_b.png

  1. 将 Demo 中的 StripFrameworks.sh 脚本文件导入到工程中。

  2. Build Phases 中增加 Run Script 过程,填入如下命令(XXX表示脚本所在的相对路径):

"${SRCROOT}/xxx/StripFrameworks.sh"

pic

此文档是否对你有帮助?
有帮助
去反馈
  • 开发环境要求
  • 目录结构
  • 集成SDK
  • 步骤1 集成准备
  • 步骤2 快速集成
  • 方法 1(推荐):通过 CocoaPods导入
  • 方法 2 :手动导入库文件
  • 步骤3 在项目中导入 SDK
  • 常见问题