共计 6204 个字符,预计需要花费 16 分钟才能阅读完成。
前言
随着实时通信技术的倒退,在线教育、视频会议、在线金融等实时互动利用的使用量越来越多,通过线上共享文档和桌面进行教学、合作、产品演示也日益广泛。多样化的场景也催生了对实时互动技术更个性化的需要,其中就包含对屏幕共享内容进行实时标注。
拍乐云 Pano 推出 业内首个反对基于实时视频、屏幕共享、文档内容流的实时标注产品,解决多个行业在线上简单交互场景下的实时互动和实时标注痛点, 更好地晋升线上互动的效率和成果。
目前 Pano SDK 已上线实时标注 API,为开发者提供便捷的接入形式,可疾速上线标注性能满足业务需要。本文以 Windows 端 C++ 接口为例,来看看如何疾速接入 Pano SDK 的共享标注性能。
筹备工作
- 拍乐云开发者账户(通过拍乐云官网注册)
- Pano SDK v1.3.3+ 版本
- 接入拍乐云屏幕共享性能(https://developer.pano.video/features/rtc/screen/)
流程
共享标注 API 用于实现在共享窗口上标注并实现各端的标注内容同步。标注性能须要确保收到 onWhiteboardAvailable 事件告诉。在开启共享后,开发者可指定须要标注的共享流。标注性能的接入分为标注发起方和接管方。
发起方
1)获取共享标注对象
2)设置标注工具格局等
3)开始标注 (startAnnotation)
4)批改标注工具格局、标注
5)完结标注 (stopAnnotation)
接管方
1)收到共享标注开始事件(onShareAnnotationStart)
2)获取共享标注对象
3)设置标注工具格局等
4)关上标注窗口(开始标注)(startAnnotation)
5)批改标注工具格局、标注
6)收到共享标注完结事件(onShareAnnotationStop)
7)获取共享标注对象
8)敞开标注窗口(完结标注)(stopAnnotation)
API 简介
1、获取共享标注对象
应用共享标注对象须要首先获取共享标注管理器对象 AnnotationManager。管理器对象能够从 PanoRtcEngine 中取得。之后从 AnnotationManager 中获取共享标注对象,接口中须要指定共享流对应的 userId。
RtcEngine
/**
- @~english
- @brief get annotation manager.
- @return
- non-null: a pointer to annotation manager
- others: Failure
- @note DO NOT delete this pointer, RtcEngine can handle its life cycle.
- @~chinese
- @brief 获取标注管理器
- @return
- 非空指针:指向标注管理器的指针。
- 空指针: 失败
- @note 不要删除此指针,RtcEgine 会保护其生命周期。
*/
virtual AnnotationManager* getAnnotationManager() = 0;
AnnotationManager
/**
- @~english
- @brief get share annotation object.
- @param userId User ID
- @return
- non-null: a pointer to the share annotation object
- others: Failure
- @note DO NOT delete this pointer, AnnotationManager can handle its le cycle.
- @~chinese
- @brief 获取共享标注对象
- @param userId 用户 ID
- @return
- 非空指针:指向共享标注对象的指针。
- 空指针: 失败
- @note 不要删除此指针,AnnotationManager 会保护其生命周期。
*/
virtual PanoAnnotation* getShareAnnotation(uint64_t userId) = 0;
2、开始、完结共享标注
在取得共享标注对象后,能够开始 / 完结标注,并告诉各端共享标注开始 / 完结
a、开始标注调用 startAnnotation, 接口须要传入一个标注视图。完结标注调用 stopAnnotation,完结共享标注。
PanoAnnotation
/**
- @~english
- @brief Start annotation and set render window
- @param window Platform specified window object, it should HWND on Windows platform.
- @return
- OK: Success
- Others: Fail
- @note
- Please make sure that whiteboard service is available before start annotation
- For share annotation at presenter, pass NULL for window parameter
- @~chinese
- @brief 开启标注并且设置显示窗口
- @param window 平台相干的窗口对象,在 windows 平台,该参数必须是 HWND 对象。
- @return
- OK:胜利
- Others: 失败
- @note
- 开启标注前须要保障白板服务是失常的。
- 对共享标注的共享端,window 参数传 NULL
*/
virtual QResult startAnnotation(void *window) = 0;
/**
- @~english
- @brief Stop the annotation.
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 进行标注
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult stopAnnotation() = 0;
Windows 传入的 window 对象为 HWND 类型,与 SubscribeScreen 中指定的 window 对象雷同。如果是共享端,传入 NULL。Pano 外部会主动创立一个与共享区域统一的通明窗口。
b、在标注管理器的回调中,有告诉共享标注的开始和完结事件,app 在收到事件后能够退出到共享标注或敞开标注视图。收到 onShareAnnotationStart 后,能够通过回调中的 userId 获取对应的标注对象。之后调用 startAnnotation 退出标注。收到 onShareAnnotationStop 后,能够调用 stopAnnotation 敞开标注。
AnnotationManager::Callback
/*!
- @~english
- @brief Notification of share annotation start
- @param userId User ID
- @~chinese
- @brief 开始共享标注告诉
- @param userId 用户 ID
*/
virtual void onShareAnnotationStart(uint64_t userId) {}
/*!
- @~english
- @brief Notification of share annotation stop
- @param userId User ID
- @~chinese
- @brief 终止共享标注告诉
- @param userId 用户 ID
*/
virtual void onShareAnnotationStop(uint64_t userId) {}
3、设置标注工具,格局,操作等
- 标注提供了多种工具和操作。通过相应接口设置或调用。目前提供的性能包含,画笔,直线,矩形,椭圆,文字等。色彩,线宽,文字粗斜体,吊销 / 重做,革除等。不反对填充类型对象。反对用户角色设置(Admin, Attendee, Viewer);
- 革除全副标注内容,清除非自己标注内容须要 Admin 角色权限。Viewer 角色仅可观看,不可标注;
- 通过设置 Viewer 角色能够敞开某个用户的标注绘制性能。设置为 Attendee 或 Admin 能够从新开启标注绘制性能;
- 快照性能能够疾速取得蕴含以后标注与共享内容的截图。
PanoAnnotation
/**
- @~english
- @brief Set annotation role type.
- @param type The annotation role type.
- @~chinese
- @brief 设置标注角色类型。
- @param type 标注角色。
*/
virtual QResult setRoleType(WBRoleType type) = 0;
/**
- @~english
- @brief set tool type
- @param type tool type
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 设置工具类型
- @paran type 工具类型
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult setToolType(WBToolType type) = 0;
/**
- @~english
- @brief set line width
- @param size line width. Valid value range [1, 20]
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 设置线宽
- @paran size 线宽。有效值范畴 [1, 20]
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult setLineWidth(int size) = 0;
/**
- @~english
- @brief Set color
- @param color Color
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 设置色彩
- @paran color 色彩
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult setColor(WBColor color) = 0;
/**
- @~english
- @brief Set font style
- @param style font style
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 设置字体款式
- @paran style 字体款式
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult setFontStyle(WBFontStyle style) = 0;
/**
- @~english
- @brief Set font size
- @param size font size
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 设置字体大小
- @paran size 字体大小
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult setFontSize(int size) = 0;
/**
- @~english
- @brief undo
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 吊销上一次操作
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult undo() = 0;
/**
- @~english
- @brief redo
- @return
- OK: Success
- Others: Fail
- @~chinese
- @brief 重做标注的上一次被撤销操作
- @return
- OK:胜利
- Others: 失败
*/
virtual QResult redo() = 0;
/**
- @~english
- @brief clear annotation content by specific user ID
- @param userId user ID
- @return
- OK: Success
- NO_PRIVILEGE: need ADMIN role to call this API
- Others: Fail
- @note ADMIN role is required if the userId is not local user
- @~chinese
- @brief 革除指定用户标注内容
- @param userId 用户 ID
- @return
- OK:胜利
- NO_PRIVILEGE: 没有权限
- Others: 失败
- @note 只有 ADMIN 角色才能够清除非本地用户的内容
*/
virtual QResult clearUserContents(uint64_t userId) = 0;
/**
- @~english
- @brief clear annotation content
- @return
- OK: Success
- NO_PRIVILEGE: need ADMIN role to call this API
- Others: Fail
- @note this API need ADMIN role
- @~chinese
- @brief 革除标注内容,须要 ADMIN 角色才可调用胜利
- @return
- OK:胜利
- NO_PRIVILEGE: 没有权限
- Others: 失败
- @note 此接口只有 ADMIN 角色才可调用
*/
virtual QResult clearContents() = 0;
/**
- @~english
- @brief save annotation contents to image.
- @param outputDir output directory
- @return
- OK: Success
- Others: Fail
- @note snapshot result and image filename is returned in callback onSnapshotComplete
- @~chinese
- @brief 保留标注内容到图像。
- @param outputDir 输入门路
- @return
- OK:胜利
- Others: 失败
- @note 快照后果和图像文件名通过回调函数 onSnapshotComplete 返回
*/
virtual QResult snapshot(const char *outputDir) = 0;
4、回调事件
通过 setCallback 注册标注对象的回调事件目前的回调事件为标注角色变动和快照实现告诉。
PanoAnnotation::Callback
/**
- @~english
- @brief Notification of annotation role type changed
- @param newRole The new role type.
- @~chinese
- @brief 标注角色类型变动告诉
- @param newRole 新角色。
*/
virtual void onAnnoRoleChanged(WBRoleType newRole) {}
/**
- @~english
- @brief Notification of annotation snapshot complete
- @param result Snapshot result
- @param filename Snapshot image full path with name.
- @~chinese
- @brief 标注快照实现告诉
- @param result 快照后果
- @param filename 快照文件名
*/
virtual void onSnapshotComplete(QResult result, const char *filename) {}
以上就是 Windows 端实时共享标注的具体教程,如需接入其余端,你也能够分割官网客服获取技术文档。_关注咱们,咱们将为大家分享更多对于音视频技术的摸索和实际,以及基于 Pano SDK 的具体开发教程。_
对于拍乐云
拍乐云成立于 2019 年,是国内第一家视频会议背景的实时互动通信云服务提供商,汇聚了一大批专一于音频、视频、白板、网络、AI 等畛域的资深技术专家。通过 Pano SDK,企业开发者即可在寰球范畴内疾速实现互动小班、超级小班、双师大班、语音聊天室、视频社交、直播连麦、游戏语音、视频客服、近程医疗、办公合作等场景。