产品文档 回放技术文档 iOS 回放 UI SDK

iOS 回放 UI SDK

git 链接: http://git.baijiashilian.com/open-ios/BJPlaybackUI.git

功能简介

回放UI SDK 是在回放Core SDK的基础上,提供了一套包含视频,PPT,聊天三个模块的基础回放UI.集成工作量小,便于快速接入和开发. 如果想在BJPlaybackCore的基础上自定义一套UI,建议先运行回放UI的Example,参考回放Core的基本用法,在此基础上进行自定义UI的开发.

1.回放相关功能

参考 iOS回放SDK

2. UI

回放界面 主机视图 用于显示摄像头采集到的视频
课件视图 用于显示白板、课件、画笔
聊天视图 用于显示聊天消息列表

Demo

1. Demo 源文件

git 上下载最新的 SDK,demo 源文件在 BJPlaybackUI 文件夹中。

2. Demo 编译、运行

  • 在 Example 的工程目录下执行 pod install

  • 使用 Xcode 打开 Example 文件夹下的 BJPlaybackUI.xcworkspace 文件

  • 选择运行设备:真机运行时,需要设置好 development team

picture

  • 使用 Xcode 运行 Example

3. Example 体验

  • Example 运行成功后将进入如下登录界面,输入回放的'教室id', sessionID(如果此参数无需输入), token 点击在线视频即可观看该直播回放 ,name 和userId可为空。

    登陆界面

  • 教室加载成功之后,进入如下主界面

    登陆界面

登陆界面

引入SDK

  • Podfile 设置 source
source 'https://github.com/CocoaPods/Specs.git'
source 'http://git.baijiashilian.com/open-ios/specs.git'
  • Podfile 中引入 BJPlaybackUI
pod 'BJPlaybackUI', '~> 1.0'
  • 在工程目录下执行 pod install

版本升级

版本号格式为 大版本.中版本.小版本[-alpha(测试版本)/beta(预览版本)]

  • 测试版本和预览版本可能很不稳定,请勿随意尝试;

  • 小版本升级只改 BUG、UI 样式优化,不会影响功能;

  • 中版本升级、修改功能,更新 UI 风格、布局,会新增 API、标记 API 即将废弃,但不会导致现有 API 不可用;

  • 大版本任何变化都是有可能的;

指定版本的方式有以下几种:

  • 固执型:pod update 时不会做任何升级,但可能无法享受到最新的 BUG 修复,建议用于 0.x 版本;
pod 'BJPlaybackUI', '1.0.0'
  • 稳妥型(推荐):pod update 时只会升级到更稳定的小版本,而不会升级中版本和大版本,不会影响功能和产品特性,升级后需要 适当测试
pod 'BJPlaybackUI', '~> 1.0.0'
  • 积极型:pod update 时会升级中版本,但不会升级大版本,及时优化,但不会导致编译出错不可用,升级后需要 全面测试
pod 'BJPlaybackUI', '~> 1.0'
  • 激进型(不推荐):pod update 时会升级大版本,可能导致编译出错、必须调整代码,升级后需要 严格测试
pod 'BJPlaybackUI'

Hello World

1. 准备创建教室

  • 引入头文件
#import <BJPlaybackUI/BJPlaybackUI.h>

2. 创建、进入回放教室

回放教室分两种创建方式 - 在线播放

    BJPRoomViewController *vc = [BJPRoomViewController onlineVideoCreateRoomWithClassId:classId
                                                                              sessionId: sessionId
                                                                                  token: token
                                                                               userName: userName
                                                                             userNumber: userNumber];
  • 本地视频播放
        BJPRoomViewController *vc = [BJPRoomViewController localVideoCreatRoomWithVideoPath:videoPath
                                                                                 signalPath:signalPath 
                                                                                 definition:definitionType 
                                                                                 isZip:YES];

  • 进入回放教室界面
        [self presentViewController:vc animated:YES completion:nil];