音视频通话

屏幕共享标注

功能介绍

在屏幕共享进行中,可开启标注功能,在共享画面上绘制图形(如箭头、圈注),供房间内所有人实时查看。标注数据由 SDK 同步,共享者和观看者均能看到。

1. 开始 / 停止标注

// 开始屏幕共享标注(需先有屏幕共享在进行)
meeting.startScreenMark();

// 停止标注
meeting.stopScreenMark();

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 收到清空标注

应用需根据这些回调更新本地标注绘制,使所有端看到一致画面。

5. 相关 API