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

开发环境要求

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

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

目录结构

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

播放器 SDK 提供两个 ZIP 包，分别是 NELivePlayer_Demo_Android_vx.x.x 和 LivePlayer_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，如下图所示。

2. Subclass of 选择 UIViewController，如下图所示。

步骤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 库文件有差异，具体以实际的库文件为准。

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

   

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

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

   

步骤3 在项目中导入 SDK

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

#import <NELivePlayerFramework/NELivePlayerFramework.h>

常见问题

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

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

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

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