Steven 5319c3c606 first commit		3 年前
..
Whiteboard	5319c3c606 first commit	3 年前
LICENSE	5319c3c606 first commit	3 年前
README-zh.md	5319c3c606 first commit	3 年前

Whiteboard

本项目为 White-SDK-iOS 的开源版本，为了更好的显示源码结构，Whiteboard 将项目分为了多个subpod，更有利于开发者查看项目源码层级。为此需要修改引用关系。

文档

官网文档 —— iOS部分

引用

在 Podfile 中写入

pod 'Whiteboard'

White-SDK-iOS 闭源库迁移

White-SDK-iOS 迁移

只需要将

#import <White-SDK-iOS/WhiteSDK.h>

修改为

#import <Whiteboard/Whiteboard.h>

即可。

使用时，只要 import 以下内容即可。

#import <Whiteboard/Whiteboard.h>
# 使用白板sdk中任意类

Example

启动Example

cd Example
pod install

进入Example文件夹，打开 Example.xcworkspace 项目文件。

同时在Whiteboard-Prefix.pch 根据代码注释填写WhiteSDKToken，WhiteAppIdentifier。

/* FIXME: sdkToken
 该 sdk token 不应该保存在客户端中，所有涉及 sdk token 的请求（当前类中所有请求），都应该放在服务器中进行，以免泄露产生不必要的风险。
 */
//#define WhiteSDKToken <#@sdk Token#>
//#define WhiteAppIdentifier <#@App identifier#>
#endif

调试特定房间

如果需要进入确定的房间进行调试，找到Whiteboard-Prefix.pch文件中，取消WhiteRoomUUID，以及WhiteRoomToken注释，同时填入指定的内容。

# 如果填写了 WhiteRoomUUID WhiteRoomToken，WhiteSDKToken 可以填写为空字符串
//#define WhiteSDKToken <#@sdk Token#>
//#define WhiteAppIdentifier <#@App identifier#>

// 如果需要进入特定房间，取消以下两行注释，同时填入对应的 UUID 以及 roomToken
//#define WhiteRoomUUID  <#Room UUID#>
//#define WhiteRoomToken <#Room Token#>

此时，如果在加入或者回放房间时，都会进入该房间。

单元测试

单元测试需要对某些特殊行为进行测试，所以需要对应房间有以下操作：

调用过插入图片接口（从单元测试启动的房间，已经开启了图片拦截功能）
发送过特定的自定义事件（已定义在单元测试代码中）
发送过大量自定义事件

要求设备

运行设备：iOS 9 + (推荐iOS 10以上使用，以获得更佳体验) 开发环境：Xcode 10+

项目结构

SDK由多个subpod组成，依赖结构如下图所示：

参数配置类：用于描述和存储API参数，返回值，状态等配置项的类。主要用于与webview进行交互。

Object：主要作用是通过YYModel处理JSON转换。包含以下部分：
1. Object基类，所有sdk中使用的参数配置类的基类。
2. Room，Player中API所涉及到的一些参数配置类。
Base：包含SDKDisplayer以及部分相关类，主要为以下部分：
1. WhiteSDK以及其初始化参数类。
2. WhiteSDK设置的通用回调WhiteCommonCallbacks
3. Room与Player共同的父类Displayer类的实现。
4. Displayer中API所使用的一些参数配置类。
5. Displayer用来描述当前房间状态的类，为RoomState,PlayerState的基类。
Room：实时房间相关内容：
1. Room类，及其相关事件回调类。
2. WhiteSDK+Room，使用SDK创建Room的API。
3. Room特有的参数配置类。
4. 描述Room状态相关的类。
Player：回放房间相关内容：
1. Player类，及其相关事件回调类。
2. WhiteSDK+Player，使用SDK创建Player的API。
3. Player特有的参数配置类。
4. 描述Player状态相关的类。
NativePlayer：在iOS端播放音视频，并与白板播放状态做同步
1. WhiteCombinePlayer类，及其相关部分类。
Converter：动静态转换请求封装类。
- 动静态转换计费以QPS（日并发）计算，客户端无法控制并发，不推荐在生产环境下使用。详情请参考文档。

Native音视频

sdk 现在支持使用 CombinePlayer，在 Native 端播放音视频，sdk 会负责音视频与白板回放的状态同步。具体代码示例，可以参看 WhitePlayerViewController

m3u8 格式的音视频，可能需要经过一次 combinePlayerEndBuffering 调用后，才能进行seek播放。（否则可能仍然从初始位置开始播放）

#import <Whiteboard/Whiteboard.h>

@implementation WhitePlayerViewController

- (void)initPlayer
{

    // 创建 WhitePlayer逻辑
    // 1. 配置 SDK 初始化参数，更多参数，可见 WhiteSdkConfiguration 头文件
    WhiteSdkConfiguration *config = [[WhiteSdkConfiguration alloc] initWithApp:[WhiteUtils appIdentifier]];
    // 2. 初始化 SDK
    self.sdk = [[WhiteSDK alloc] initWithWhiteBoardView:self.boardView config:config commonCallbackDelegate:self.commonDelegate];

    // 3. 配置 WhitePlayerConfig，room uuid 与 roomToken 为必须。其他更多参数，见 WhitePlayerConfig.h 头文件
    WhitePlayerConfig *playerConfig = [[WhitePlayerConfig alloc] initWithRoom:self.roomUuid roomToken:self.roomToken];
    
    //音视频，白板混合播放处理类
    self.combinePlayer = [[WhiteCombinePlayer alloc] initWithMediaUrl:[NSURL URLWithString:@"https://netless-media.oss-cn-hangzhou.aliyuncs.com/c447a98ece45696f09c7fc88f649c082_3002a61acef14e4aa1b0154f734a991d.m3u8"]];
    //显示 AVPlayer 画面
    [self.videoView setAVPlayer:self.combinePlayer.nativePlayer];
    //配置代理
    self.combinePlayer.delegate = self;
    
    [self.sdk createReplayerWithConfig:playerConfig callbacks:self.eventDelegate completionHandler:^(BOOL success, WhitePlayer * _Nonnull player, NSError * _Nonnull error) {
        if (self.playBlock) {
            self.playBlock(player, error);
        } else if (error) {
            NSLog(@"创建回放房间失败 error:%@", [error localizedDescription]);
        } else {
            self.player = player;
            [self.player addHighFrequencyEventListener:@"a" fireInterval:1000];
            
            //配置 WhitePlayer
            self.combinePlayer.whitePlayer = player;/Users/Agora/Documents/Agora/Whiteboard-iOS/README-zh.md
            //WhitePlayer 需要先手动 seek 到 0 才会触发缓冲行为
            [player seekToScheduleTime:0];
        }
    }];
}

#pragma mark - WhitePlayerEventDelegate

- (void)phaseChanged:(WhitePlayerPhase)phase
{
    NSLog(@"player %s %ld", __FUNCTION__, (long)phase);
    // 注意！必须完成该操作，WhiteCombinePlayer 才能正确同步状态
    [self.combinePlayer updateWhitePlayerPhase:phase];
}

// 其他回调方法...

#pragma mark - WhiteCombinePlayerDelegate
- (void)combinePlayerStartBuffering
{
    //任意一端进入缓冲
    NSLog(@"combinePlayerStartBuffering");
}

- (void)combinePlayerEndBuffering
{
    //两端都结束缓冲
    NSLog(@"combinePlayerEndBuffering");
}

@end

动态ppt本地资源包

原理：提前下载动态转换所有需要的资源包，使用 WKWebView iOS 11 开始支持的自定义 scheme 请求，拦截 webView 请求，返回 native 端本地资源。

具体实现，请查看 git 记录：

所需依赖：add dependency to demo for ppt zip feature
代码实现：implement local zip >注意，当前 demo 中，实现拦截，还需要在WhiteBaseViewController.m中，将WhitePptParams的 scheme 参数为kPPTScheme。

动态转换资源包

部分问题

目前 SDK 关键字为White，未严格使用前置三大写字母做前缀。

Whiteboard - Framework 拖拽方式集成

Framework 打包(需安装pod package 插件:sudo gem install cocoapods-packager)

pod package Whiteboard.podspec --embedded --force (基于Github源码)
pod package Whiteboard.podspec --force --embedded --local(基于本地源码)
注意: --local 控制符需要安装以下内容
gem install specific_install gem specific_install https://github.com/CocoaPods/cocoapods-packager

关于Framework 手动添加
Whiteboard.framework yymodel.framework dsBridge.framework 一并拖入Embed设置为 Do not embed

FAQ：
遇到问题：have the same architectures (arm64) and can't be in the same fat output file
参考
1.https://github.com/CocoaPods/cocoapods-packager/issues/259

2.“could not build module xxx” 报错：修改工程target - Allow Non-modular Includes In Framework Modules

3.Command CodeSign failed with a nonzero exit code报错 Whiteboard.framework 改为Do not embed

TODO:framework bundle 路径有问题

README-zh.md