Pano开发者中心
  • 开发者中心
  • 下载中心

›白板

新手入门

  • 简介
  • 名词解释
  • 创建第一个应用

规则说明

  • Channel ID命名规则
  • 权限控制
  • 计费说明
  • 频道最大时长说明
  • 每月一万分钟免费说明
  • 布局参数说明
  • 水印

场景方案

    教育行业

    • 1vN互动小班课
    • 互动直播大班课

快速接入

  • 简介
  • 音视频

    • Windows (C++)
    • iOS (Objective-C)
    • Android (Java)
    • Web
    • Electron
    • Flutter
    • React Native
    • Unity

    白板

    • Windows (C++)
    • iOS (Objective-C)
    • Android (Java)
    • Web
    • Electron
    • Flutter
    • React Native

高级功能(RTC)

  • 简介
  • 屏幕共享
  • 分组讨论
  • 状态回调
  • 设备诊断
  • 音量指示
  • 控制声音
  • 声卡操作
  • 混音/伴音
  • 混响
  • 耳返
  • 变声
  • 美颜
  • 音视频数据回调
  • 音视频外部采集
  • 收发多路视频
  • 多窗口渲染
  • 性能检测
  • 截图
  • 反馈

高级功能(RTS)

  • 简介
  • 白板

    • Windows (C++)
    • iOS (Objective-C)
    • Android (Java)
    • Web
    • Flutter

    标注

    • 视频标注
    • 共享标注
    • 外部标注

    消息

    • 消息服务

    远程控制

    • 远程控制

操作实践

  • 切换大小屏

RESTful API

  • 基本格式
  • 生成Token
  • 频道管理
  • 云端录制
  • CDN推流
  • 文档转码
  • 消息服务
  • 服务端消息通知

SDK API

  • SDK接口说明
  • Windows (C++)
  • macOS/iOS (Objective-C)
  • Android (Java)
  • Web SDK (IE专用版)
  • Web SDK

    • 浏览器兼容性
    • RtcEngine
    • GroupManager
    • RtcWhiteboard
    • RtsService
    • RtcMessage
    • Annotation
    • Constants

更新记录

  • 简介
  • Windows
  • macOS
  • iOS
  • Android
  • Electron
  • Flutter
  • React Native
  • Unity
  • Web(全功能SDK)
  • Web(RTS SDK)
  • Web(IE专用音视频SDK)

帮助

  • FAQ
  • 更多帮助

iOS (Objective-C)

本文介绍 iOS 白板的部分高级功能。

请先查看 iOS 白板快速接入指南 了解基本功能后,再查看此文档。

文档操作

Pano 支持多白板,每块白板支持多份文档,每份文档支持多个页面。
即白板的层级结构为:白板 -> 文档 -> 页面。

初始化 PanoRtcWhiteboard 实例时,会自动生成 docId 为 "default" 的只有一页的默认文档。

创建文档

可以通过以下 3 种方式创建新文档。

1、导入背景图片创建新文档

通过 PanoRtcWhiteboard 实例的 - createDocWithImages: 方法导入指定数量的背景图片并创建新的白板文档。

  • 如果导入多张背景图片,则新创建的白板文档也相应有多页。此操作会触发 - onDocCreate:file: 事件。
  • 背景图片缩放模式 会决定导入后背景图片的布局。
NSString * url1 = @"..."; // 仅支持网络路径
NSString * url2 = @"...";
NSArray * urls = @[url1, url2];
[self.whiteboardEngine createDocWithImages:urls];

2、上传文件创建新文档

通过 PanoRtcWhiteboard 实例的 - createDocWithFilePath: 或 - createDocWithFilePath:convertParam: 方法上传本地需转码的文件并创建新的白板文档。

  • 仅支持 pdf、pptx、ppt、docx、doc、xlsx、xls 格式的文件。
  • 文件上传后会自动转码,转码成功后会自动创建一份新的白板文档,此操作会触发 - onDocCreate:file: 事件(其中返回 fileId 表示创建的白板文档)。
    随后可以调用 - getFileInfo: 方法传入 fileId 获取 docId (表示上传的文件转码后的文档ID) 等信息。
  • 如果上传的文件有多页,则新创建的白板文档也相应有多页。

为了获得更好的体验,请参考 文档转码建议。

[self.whiteboardEngine createDocWithFilePath:...];
/*
PanoWBConvertConfig * convertConfig = [[PanoWBConvertConfig alloc] init];
// PanoWBConvertType 包括:kPanoWBConvertJPG (默认值), kPanoWBConvertPNG, kPanoWBConvertH5, kPanoWBConvertPDF
convertConfig.type = PanoWBConvertType.kPanoWBConvertJPG;
convertConfig.needThumb = NO;
[self.whiteboardEngine createDocWithFilePath:... convertParam:convertConfig];
*/

3、加载已转码文档

通过 PanoRtcWhiteboard 实例的 - addDoc: 方法,传入 docId 或 URL 加载已转码文档(文档转码相关内容请 点此查看)。

PanoWBDocContents * contents = [[PanoWBDocContents alloc] init];
contents.name = "白板文档名称";
contents.docId = "123456789"; // 通过 docId 来加载已转码文档
// contents.urls = @[@"https://...", @"https://...", ...]; // 通过 URL 来加载
[self.whiteboardEngine contents];

列举文档

通过 PanoRtcWhiteboard 实例的 - enumerateFiles 方法列举文档,将返回文档ID列表。

[self.whiteboardEngine enumerateFiles];

获取当前白板文档ID

通过 PanoRtcWhiteboard 实例的 - getCurrentFileId 方法获取当前白板文档ID。

[self.whiteboardEngine getCurrentFileId];

切换文档

通过 PanoRtcWhiteboard 实例的 - switchDoc: 方法切换文档。

[self.whiteboardEngine switchDoc:@"123456"];

删除文档

通过 PanoRtcWhiteboard 实例的 - deleteDoc: 方法删除文档(默认文档不支持删除)。

[self.whiteboardEngine deleteDoc:@"123456"];

获取当前页码

通过 PanoRtcWhiteboard 实例的 - getCurrentPageNumber 方法获取当前页码(页码从 1 开始)。

self.curPage = [self.whiteboardEngine getCurrentPageNumber];

获取当前文档页码总数

通过 PanoRtcWhiteboard 实例的 - getTotalNumberOfPages 方法获取当前文档的页码总数。

self.totalPages = [self.whiteboardEngine getTotalNumberOfPages];

切换页码

通过 PanoRtcWhiteboard 实例的 - prevPage 方法切换到当前文档的上一页,- nextPage 方法切换到下一页。

// [self.whiteboardEngine prevPage]; // 切换到当前文档的上一页
[self.whiteboardEngine nextPage]; // 切换到下一页

通过 PanoRtcWhiteboard 实例的 - gotoPage: 方法切换到指定页面(页码从 1 开始)。

[self.whiteboardEngine gotoPage:1];

切换页码、添加页码、删除页面 会触发 - onPageNumberChanged:withTotalPages: 回调。

添加页面

通过 PanoRtcWhiteboard 实例的 - addPage: 方法添加一个新页面到当前文档最后。

  • 添加页面是异步的,添加成功后会触发 - onContentUpdated 事件,随后可以通过 - getTotalNumberOfPages 方法获取当前文档页码总数,通过 - getCurrentPageNumber 方法获取当前页码。
  • autoSwitch 参数表示是否自动切换到新页面。
[self.whiteboardEngine addPage:YES];

添加页面到指定位置

通过 PanoRtcWhiteboard 实例的 - insertPage:autoSwitch: 方法添加一个新页面到 pageNo 之后(页码从 1 开始)。

  • 如果传入的 pageNo 参数超出文档页码总数,会返回 kPanoResultFailed。
  • autoSwitch 参数表示是否自动切换到新页面。
[self.whiteboardEngine insertPage:1 autoSwitch:YES];

删除页面

通过 PanoRtcWhiteboard 实例的 - removePage: 或 - removePage:switchNext: 方法删除指定页面。
默认行为是切换到被删除页的前一页(若有)。当 switchNext 设置为 true 时切换到被删除页的后一页。

[self.whiteboardEngine removePage:self.curPage];

视角跟随

视角跟随指的是和其他用户同步缩放或移动。

事件通知

请注意监听视角跟随相关的事件通知:

  • - onVisionShareStarted::用户开始分享视角
  • - onVisionShareStopped::用户停止分享视角

分享视角

通过 PanoRtcWhiteboard 实例的 - startShareVision 方法分享视角,- stopShareVision 方法停止分享。
开始和停止时,其他用户会收到通知。

同一时刻只能有一位用户分享视角,后分享的用户会导致正在分享的用户自动停止分享(后发抢占模式)。

[self.whiteboardEngine startShareVision];

跟随视角

通过 PanoRtcWhiteboard 实例的 - startFollowVision 方法跟随他人视角,- stopFollowVision 方法停止跟随。

[self.whiteboardEngine startFollowVision];

其他操作

固定白板宽高

Pano 白板默认是无界的,但是有的场景下开发者可能需要固定白板宽高。
通过 PanoRtcWhiteboard 实例的 - initVision: (PanoWBVisionConfig *)config 方法设置白板宽高。
将 PanoWBVisionConfig 的 limited 参数指定为 YES 来固定宽高。

  • 各端设置的宽高数值需要保持一致。
  • 打开白板时 open 接口传入的视图的宽高比需要和此处传入的宽高比保持一致。
PanoWBVisionConfig *wbVisionConfig = [[PanoWBVisionConfig alloc]init];
wbVisionConfig.width = 640;
wbVisionConfig.height= 360;
wbVisionConfig.limited = YES;
[self.whiteboardEngine initVision:wbVisionConfig];

广播消息

通过 PanoRtcWhiteboard 实例的 - broadcastMessage: 方法广播消息(发给白板频道内所有用户)。

NSDictionary * dict = [[NSDictionary alloc] init];
[dict setValue:@"这是一条广播消息" forKey:@"msg"];
// options 设置为 nil,转换后的 JSON 不会包含回车和换行
NSData * json = [NSJSONSerialization dataWithJSONObject:dict options:nil error:nil];
// 此接口只要求 message 参数为 NSData 格式,但是为便于和其他端兼容解析,建议封装为 JSON 格式
[self.whiteboardEngine broadcastMessage:json];

发送消息

通过 PanoRtcWhiteboard 实例的 - sendMessage:toUser: 方法向特定用户发送消息。

NSDictionary * dict = [[NSDictionary alloc] init];
[dict setValue:@"这是一条定向消息" forKey:@"msg"];
// options 设置为 nil,转换后的 JSON 不会包含回车和换行
NSData * json = [NSJSONSerialization dataWithJSONObject:dict options:nil error:nil];
// 此接口只要求 message 参数为 NSData 格式,但是为便于和其他端兼容解析,建议封装为 JSON 格式
[self.whiteboardEngine sendMessage:json toUser:12345];

截图

截图当前页面

通过 PanoRtcWhiteboard 实例的 - snapshot:path: 方法将当前白板页面截图。

  • mode 参数含义:kPanoWBSnapshotView - 可见区域, kPanoWBSnapshotAll - 整个页面。
  • 截图结果将触发 - onSnapshotComplete:name: 回调。
[self.whiteboardEngine snapshot:kPanoWBSnapshotAll path:documentPath];

截图特定文档所有页面

通过 PanoRtcWhiteboard 实例的 - saveDocToImages:path: 方法将特定白板文档的所有页面截图。

  • 每个页面保存为一张图片,图片名称格式为:whiteboard_[fileId]_[page number].png, 例如:whiteboard_default_1.png。
  • 截图结果将触发 - onDocSave:file:path: 和 - onSnapshotComplete:name: 回调。
[self.whiteboardEngine saveDocToImages:@"12345" path:documentPath];

多白板

切换与获取白板

Pano 白板支持多白板的特色功能。
例如,对于多人教学场景,老师和学生之间可以使用一块公共白板,用于老师授课。
每位学生也可以有一块自己的白板,用于提交各自的学习内容。
老师可以切换查看公共白板和每位特定学生的白板,每位学生也可以切换查看公共白板和自己的白板。

通过 PanoRtcEngineKit 实例的 - switchWhiteboardEngine: 方法切换白板,然后通过 - whiteboardEngine 方法来获取白板,随后即可调用 PanoRtcWhiteboard 实例的 open 方法打开该白板。
(SDK版本1.3.8+)可以通过 PanoRtcWhiteboard 实例的 - getCurrentWhiteboardId 方法获取当前白板ID。

// - switchWhiteboardEngine: 方法的 whiteboardId 参数是由开发者自定义的白板ID
[self.engineKit switchWhiteboardEngine:@"Student1"];
self.whiteboardEngine = [self.engineKit whiteboardEngine]; // 此后即可打开 "Student1" 白板
wbId = [self.whiteboardEngine getCurrentWhiteboardId]; // "Student1"
...
[self.engineKit switchWhiteboardEngine:@"default"]; // 切换到默认白板(公共白板)
self.whiteboardEngine = [self.engineKit whiteboardEngine]; // 此后即可打开 "default" 白板
wbId = [self.whiteboardEngine getCurrentWhiteboardId]; // "default"
  • 如果从未调用过 - switchWhiteboardEngine: 方法,直接调用 - whiteboardEngine 方法,PanoRtcEngineKit 会自动创建 ID 为 "default" 的默认白板。
  • 如果先调用 - switchWhiteboardEngine: 方法再调用 - whiteboardEngine 方法,则会获取到最近一次切换的白板。
  • 前缀为 "pano-" 的白板ID为保留值,开发者请不要使用。

停止白板

通过 PanoRtcWhiteboard 实例的 - stop 方法停止白板(注意:默认白板不能停止),此方法会指示服务器销毁当前白板并踢出所有加入该白板的用户,请谨慎使用。

[self.whiteboardEngine stop];

open/close/leave/stop的区别

  • open: 开启白板并且设置显示窗口,并且开始计费
    • 对于默认白板,如果任意用户调用 open 接口,则加入该白板频道的所有用户都会自动连接默认白板并开始计费。
    • 对于自定义白板(多白板),各用户调用 open 接口时仅本人开始计费。
  • close: 关闭白板UI,不会销毁本地白板,不会断开白板服务,不会停止本人计费 (可以重新open)
  • leave: 关闭白板UI,销毁本地白板,断开白板服务,停止本人计费 (可以重新open)
  • stop: 关闭白板UI,销毁本地白板,断开白板服务,踢出该白板内所有用户,停止所有用户计费
Last updated on 2022/3/9
← Windows (C++)Android (Java) →
  • 文档操作
    • 创建文档
    • 列举文档
    • 获取当前白板文档ID
    • 切换文档
    • 删除文档
    • 获取当前页码
    • 获取当前文档页码总数
    • 切换页码
    • 添加页面
    • 添加页面到指定位置
    • 删除页面
  • 视角跟随
    • 事件通知
    • 分享视角
    • 跟随视角
  • 其他操作
    • 固定白板宽高
    • 广播消息
    • 发送消息
    • 截图
  • 多白板
    • 切换与获取白板
    • 停止白板
  • open/close/leave/stop的区别
浙ICP备20002645号 ©2019-2022 Pano拍乐云