屏幕共享标注
功能介绍
在屏幕共享进行中,可开启标注功能,在共享画面上绘制图形(如箭头、圈注),供房间内所有人实时查看。标注数据由 SDK 同步,共享者和观看者均能看到。
1. 开始 / 停止标注
// 开始屏幕共享标注(需先有屏幕共享在进行)
meeting.startScreenMark();
// 停止标注
meeting.stopScreenMark();
- 开始结果:startScreenMarkRslt
- 停止结果:stopScreenMarkRslt
- 状态查询:isScreenMarkedState
2. 发送标注数据
用户绘制后,将标注数据通过 sendScreenMarkData 发送,格式参考 CRScreenMarkData:
const char* jsonMarkDat = R"({
"markid": "mark_001",
"userid": "myUserID",
"penType": 1,
"penWidth": 3,
"color": "#FF0000",
"points": [65536, 131072, 196608, 262144]
})";
meeting.sendScreenMarkData(jsonMarkDat);
| 参数 | 类型 | 说明 |
|---|---|---|
| markid | string | 标注 ID,唯一标识 |
| userid | string | 标注所属用户 ID |
| penType | int | 画笔类型:1 铅笔,2 水笔 |
| penWidth | int | 画笔宽度 |
| color | string | 颜色,如 #RGB、#RRGGBB、#AARRGGBB |
| points | array | 点序列,每点 uint32:高 16 位 x,低 16 位 y |
3. 删除与清空标注
// 删除指定标注
const char* jsonDelIds = R"(["mark_001", "mark_002"])";
meeting.delScreenMarkData(jsonDelIds);
// 清空所有标注
meeting.clearScreenMarks();
4. 接收标注同步
其他端发送的标注会通过以下回调同步到本端:
| 回调 | 说明 |
|---|---|
| notifyScreenMarkStarted | 有人开始标注 |
| notifyScreenMarkStopped | 有人停止标注 |
| notifySendScreenMarkData | 收到新的标注数据 |
| notifyDelScreenMarkData | 收到标注删除 |
| notifyClearScreenMarks | 收到清空标注 |
应用需根据这些回调更新本地标注绘制,使所有端看到一致画面。