Zoom Meeting SDK Windows 视频高级功能实战远程 PTZ 摄像头控制、画廊视频排序与本地摄像头管理【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本文是 knowledge-work-plugins 仓库中 video-advanced.md 的深度实战指南聚焦 Zoom Windows Meeting SDK 的IMeetingVideoController提供的三个 Level 3 子 Helper远程摄像头 PTZ 控制、画廊视图批量视频排序与本地摄像头设备管理。阅读本文后你将掌握完整的导航路径、事务式批量排序模式、权限请求/回调链路以及可直接落地的 C 完整示例代码。概览三个 Level 3 子 HelperIMeetingVideoController是会议视频域的总控制器Singleton它向下派生了三个用于高级视频操作的 Level 3 子 HelperHelperGetter平台用途IMeetingCameraHelperGetMeetingCameraHelper(userid)跨平台远程 PTZ 摄像头控制平移/倾斜/变焦ISetVideoOrderHelperGetSetVideoOrderHelper()仅 Windows画廊视图中批量设置视频顺序ICameraControllerGetMyCameraController()仅 Windows控制本地摄像头设备从 singleton-hierarchy.md 的完整服务树可以看到这三个 Helper 均位于 Level 2 控制器IMeetingVideoController之下、属于 [LEAF] 叶子节点。其中IMeetingCameraHelper是跨平台能力而ISetVideoOrderHelper与ICameraController是 Windows 专属能力在 Windows 平台开发时要注意用#if defined(WIN32)宏保护参见 SKILL.md 中关于 Windows-only 控制器的平台可用性说明。导航路径从 IMeetingService 到视频高级能力SDK 采用服务定位器模式Service Locator你不需要自行构造对象而是沿着单例树逐层导航。视频高级功能的完整导航路径如下IMeetingService └─► GetMeetingVideoController() ├─► GetMeetingCameraHelper(userid) // 远程摄像头 PTZ 控制跨平台 ├─► GetSetVideoOrderHelper() // 画廊视频顺序仅 Windows └─► GetMyCameraController() // 本地摄像头设备仅 Windows这一路径遵循仓库中反复强调的通用三步模式见 sdk-architecture-pattern.md获取控制器/Helper单例模式meetingService-GetMeetingVideoController()实现事件监听接口观察者模式继承IMeetingVideoCtrlEvent并实现全部纯虚方法注册监听并使用videoCtrl-SetEvent(listener)后调用控制方法。实践要点控制器在未进入会议时返回nullptr且加入/离开会议后旧指针可能失效。因此应在MEETING_STATUS_INMEETING回调之后重新获取控制器并始终检查nullptr详见 singleton-hierarchy.md 的Practical Rules。一、远程摄像头控制IMeetingCameraHelper跨平台IMeetingCameraHelper用于控制已授予权限的远端参会者的 PTZPan-Tilt-Zoom摄像头典型场景包括远程课堂、手术示教、监控直播等需要远端视角调整的应用。1.1 获取 Helper// Get video controller first IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; // Get camera helper for specific user unsigned int targetUserId 12345; IMeetingCameraHelper* cameraHelper videoCtrl-GetMeetingCameraHelper(targetUserId); if (!cameraHelper) { // User doesnt exist or doesnt have controllable camera return; }注意GetMeetingCameraHelper(userid)需要传入目标用户 ID且返回nullptr可能意味着用户不存在或对方没有可控制的摄像头。1.2 检查可控制性并请求控制获取 Helper 后先通过CanControlCamera()判断是否已具备控制权若未具备则需要通过RequestControlRemoteCamera()发起控制请求并等待回调确认权限授予——请求是异步的不能立即操作摄像头// Check if we can control this users camera if (!cameraHelper-CanControlCamera()) { // Need to request control first SDKError err cameraHelper-RequestControlRemoteCamera(); if (err ! SDKERR_SUCCESS) { // Request failed - user may not have PTZ camera } // Wait for callback to confirm permission granted return; }1.3 摄像头移动操作// All movement methods accept range 10-100 (default: 50) // Higher faster/larger movement // Pan left/right cameraHelper-TurnLeft(50); // Pan left cameraHelper-TurnRight(50); // Pan right // Tilt up/down cameraHelper-TurnUp(50); // Tilt up cameraHelper-TurnDown(50); // Tilt down // Zoom in/out cameraHelper-ZoomIn(50); // Zoom in cameraHelper-ZoomOut(50); // Zoom out所有移动方法的参数范围均为 10–100默认值为 50数值越大表示移动/变焦速度越快或幅度越大。实际控制时建议由小到大渐进调整避免画面大幅跳动。1.4 释放控制// When done controlling cameraHelper-GiveUpControlRemoteCamera();控制完成后务必调用GiveUpControlRemoteCamera()主动释放避免长期占用远端摄像头的控制权。1.5 处理摄像头控制请求事件回调作为被控制方或请求方都需要通过继承IMeetingVideoCtrlEvent的监听器来处理两类回调onCameraControlRequestReceived对方请求控制我们的摄像头被控制方视角通过ICameraControlRequestHandler的Approve()/Decline()决定是否批准onCameraControlRequestResult我们发起的控制请求的结果请求方视角区分Approve/Decline/Revoke三种结果。class MyCameraEventHandler : public IMeetingVideoCtrlEvent { public: void onCameraControlRequestReceived( unsigned int userId, CameraControlRequestType requestType, ICameraControlRequestHandler* pHandler) override { if (requestType CameraControlRequestType_RequestControl) { // Someone wants to control our camera // Approve or decline pHandler-Approve(); // or pHandler-Decline(); } else if (requestType CameraControlRequestType_GiveUpControl) { // User released control of our camera } } void onCameraControlRequestResult( unsigned int userId, CameraControlRequestResult result) override { switch (result) { case CameraControlRequestResult_Approve: // Our request was approved - can now control camera break; case CameraControlRequestResult_Decline: // Our request was declined break; case CameraControlRequestResult_Revoke: // Our control was revoked break; } } // ... other callback implementations };接口完整性提醒IMeetingVideoCtrlEvent是一组纯虚接口漏实现任何一个都会导致 C2259 cannot instantiate abstract class 编译错误。仓库 interface-methods.md 明确要求实现所有纯虚方法包括#if defined(WIN32)内的平台专属方法不需要的方法实现为空桩即可。二、画廊视图视频排序ISetVideoOrderHelper仅 WindowsISetVideoOrderHelper用于在画廊视图Gallery View中批量设置参会者视频的顺序适合需要把特定人员如主持人、讲师、翻译固定到特定位置的场景。2.1 获取 Helper#if defined(WIN32) IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; ISetVideoOrderHelper* orderHelper videoCtrl-GetSetVideoOrderHelper(); if (!orderHelper) return; #endif2.2 事务模式批量排序Transaction Pattern与仓库中IBatchCreateBOHelper的批量创建会议室见 singleton-hierarchy.md 的 Level 4 批量操作示例采用相同的事务三段式设计——Begin → Add → Commit#if defined(WIN32) // Step 1: Begin transaction (clears any previous prepared order) SDKError err orderHelper-SetVideoOrderTransactionBegin(); if (err ! SDKERR_SUCCESS) return; // Step 2: Add users to positions (0-based, max 49 positions) // Position 0 first slot in gallery orderHelper-AddVideoToOrder(hostUserId, 0); // Host at position 0 orderHelper-AddVideoToOrder(presenter1Id, 1); // Presenter at position 1 orderHelper-AddVideoToOrder(presenter2Id, 2); // Another presenter at position 2 // ... add more as needed // Step 3: Commit the transaction err orderHelper-SetVideoOrderTransactionCommit(); if (err ! SDKERR_SUCCESS) { // Commit failed } #endif位置编号从 0 开始AddVideoToOrder(userId, position)把指定用户放置到画廊的指定槽位。2.3 重要注意事项最多可排序 49 个用户若同一位置被分配给多个用户只有最后添加的一个生效添加用户前必须先调用SetVideoOrderTransactionBegin()开启事务该调用会清空此前准备的顺序只有主持人/联席主持人host/co-host能为所有参会者设置视频顺序可使用EnableFollowHostVideoOrder()让参会者跟随主持人的视频顺序。2.4 跟随主持人视频顺序Follow Host Video Order// Check if feature is supported if (videoCtrl-IsSupportFollowHostVideoOrder()) { // Enable following hosts video order videoCtrl-EnableFollowHostVideoOrder(true); // Check if currently following bool isFollowing videoCtrl-IsFollowHostVideoOrderOn(); } // Get current video order list IListunsigned int* orderList videoCtrl-GetVideoOrderList(); if (orderList) { for (int i 0; i orderList-GetCount(); i) { unsigned int userId orderList-GetItem(i); // Process ordered user IDs } }GetVideoOrderList()返回当前顺序的用户 ID 列表IListunsigned int可通过GetCount()/GetItem(i)遍历。使用前先通过IsSupportFollowHostVideoOrder()探测当前 SDK 版本是否支持该能力是稳妥的做法仓库 sdk-architecture-pattern.md 中Check Availability Before Use模式同样适用于这里。三、本地摄像头设备控制ICameraController仅 WindowsICameraController用于控制本地用户的摄像头设备设置例如切换设备、调整设备参数等#if defined(WIN32) IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; ICameraController* cameraCtrl videoCtrl-GetMyCameraController(); if (!cameraCtrl) return; // ICameraController provides device-level camera control // (Interface details depend on SDK version - check headers) #endif注意ICameraController的具体接口方法随 SDK 版本不同而存在差异接入时以你所使用 SDK 版本的meeting_service_components头文件为准仓库文档基于 Zoom Windows Meeting SDK v6.7.2.26830见 SKILL.md。SDK 头文件按功能拆分命名如meeting_[feature]_interface.h可在SDK/x64/h/meeting_service_components/目录下定位对应声明。四、视频排序回调Video Order Callbacks当主持人或其他参会者改变视频顺序时通过IMeetingVideoCtrlEvent的三个回调感知变化并同步 UIclass MyVideoEventHandler : public IMeetingVideoCtrlEvent { public: void onHostVideoOrderUpdated(IListunsigned int* orderList) override { // Host changed the video order // Update UI to reflect new order if (orderList) { for (int i 0; i orderList-GetCount(); i) { unsigned int userId orderList-GetItem(i); // Reorder video tiles accordingly } } } void onLocalVideoOrderUpdated(IListunsigned int* localOrderList) override { // Local video order changed (users personal arrangement) } void onFollowHostVideoOrderChanged(bool bFollow) override { // Following host video order setting changed if (bFollow) { // Now following hosts order } else { // Using local order } } // ... other callback implementations };三个回调分别对应三种场景回调触发时机典型处理onHostVideoOrderUpdated(orderList)主持人更新了全局视频顺序按新顺序重排视频瓦片onLocalVideoOrderUpdated(localOrderList)本地个人排列顺序变化更新本地视图onFollowHostVideoOrderChanged(bFollow)跟随主持人顺序开关变化切换跟随/本地两种布局逻辑五、完整示例摄像头控制流程管理器下面把远程摄像头控制的全流程封装为CameraControlManager类涵盖初始化、请求控制、授予后操作、释放控制以及完整的回调实现——可直接作为项目骨架class CameraControlManager : public IMeetingVideoCtrlEvent { private: IMeetingVideoController* m_videoCtrl nullptr; IMeetingCameraHelper* m_currentCameraHelper nullptr; public: void Initialize(IMeetingService* meetingService) { m_videoCtrl meetingService-GetMeetingVideoController(); if (m_videoCtrl) { m_videoCtrl-SetEvent(this); } } void RequestCameraControl(unsigned int targetUserId) { if (!m_videoCtrl) return; m_currentCameraHelper m_videoCtrl-GetMeetingCameraHelper(targetUserId); if (!m_currentCameraHelper) { // User not found or no controllable camera return; } if (m_currentCameraHelper-CanControlCamera()) { // Already have control OnCameraControlGranted(); } else { // Request control m_currentCameraHelper-RequestControlRemoteCamera(); } } void OnCameraControlGranted() { // Now can control camera // Example: Center the camera m_currentCameraHelper-TurnLeft(30); m_currentCameraHelper-TurnUp(20); } void ReleaseCameraControl() { if (m_currentCameraHelper) { m_currentCameraHelper-GiveUpControlRemoteCamera(); m_currentCameraHelper nullptr; } } // IMeetingVideoCtrlEvent implementations void onCameraControlRequestResult(unsigned int userId, CameraControlRequestResult result) override { if (result CameraControlRequestResult_Approve) { OnCameraControlGranted(); } else { m_currentCameraHelper nullptr; } } void onCameraControlRequestReceived(unsigned int userId, CameraControlRequestType requestType, ICameraControlRequestHandler* pHandler) override { // Auto-approve camera control requests if (requestType CameraControlRequestType_RequestControl) { pHandler-Approve(); } } // ... implement other required callbacks void onUserVideoStatusChange(unsigned int userId, VideoStatus status) override {} void onSpotlightedUserListChangeNotification(IListunsigned int* lst) override {} void onHostRequestStartVideo(IRequestStartVideoHandler* handler) override {} void onActiveSpeakerVideoUserChanged(unsigned int userid) override {} void onActiveVideoUserChanged(unsigned int userid) override {} void onHostVideoOrderUpdated(IListunsigned int* orderList) override {} void onLocalVideoOrderUpdated(IListunsigned int* localOrderList) override {} void onFollowHostVideoOrderChanged(bool bFollow) override {} void onUserVideoQualityChanged(VideoConnectionQuality quality, unsigned int userid) override {} void onVideoAlphaChannelStatusChanged(bool isAlphaModeOn) override {} };代码中的关键设计点Initialize()统一注册监听通过videoCtrl-SetEvent(this)注册事件之后所有摄像头与视频排序回调都会路由到该类请求控制后由回调驱动RequestControlRemoteCamera()是异步的真正开始操作是在onCameraControlRequestResult收到Approve之后通过OnCameraControlGranted()触发空桩实现保证编译通过其余IMeetingVideoCtrlEvent纯虚方法均以空实现补齐避免抽象类实例化错误释放后置空指针GiveUpControlRemoteCamera()后立即将m_currentCameraHelper置空防止悬垂指针。集成前置条件消息循环、头文件顺序与平台宏仓库 SKILL.md 强调接入以上任何视频功能前必须满足三个前提1. Windows 消息循环回调不触发的头号原因SDK 通过 Windows 消息泵派发异步回调。没有消息循环回调只会入队而永远不被执行——表现为权限请求永远得不到结果、排序回调不触发。主循环示例MSG msg; while (!g_exit) { while (PeekMessage(msg, NULL, 0, 0, PM_REMOVE)) { if (msg.message WM_QUIT) { g_exit true; break; } TranslateMessage(msg); DispatchMessage(msg); } std::this_thread::sleep_for(std::chrono::milliseconds(100)); }2. 头文件包含顺序#include windows.h // MUST be first #include cstdint // MUST be second (SDK headers use uint32_t) // ... other standard headers ... #include zoom_sdk.h #include meeting_service_components/meeting_audio_interface.h // BEFORE participants! #include meeting_service_components/meeting_participants_ctrl_interface.h视频控制器相关头文件meeting_video_interface.h等遵循同样的包含顺序约束。3. Windows 专属接口的平台保护ISetVideoOrderHelper与ICameraController仅存在于 Windows 平台。若应用需要跨平台编译必须将相关调用包裹在#if defined(WIN32)中避免在其他平台出现编译错误。相关文档singleton-hierarchy.md —— SDK 完整服务树导航图视频域三个 Level 3 Helper 的层级定位sdk-architecture-pattern.md —— 适用于全部 35 控制器的通用三步实现模式SKILL.md —— Windows Meeting SDK 总览、工程配置与快速上手interface-methods.md —— 事件监听接口全部纯虚方法的实现规范windows-reference.md —— Visual Studio 工程配置、SDKError 错误码与常见问题排查仓库基于 Zoom Windows Meeting SDK v6.7.2.26830 编写不同 SDK 版本的接口方法与枚举可能存在差异请以实际使用的 SDK 头文件为准。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Zoom Meeting SDK Windows 视频高级功能实战：远程 PTZ 摄像头控制、画廊视频排序与本地摄像头管理
Zoom Meeting SDK Windows 视频高级功能实战远程 PTZ 摄像头控制、画廊视频排序与本地摄像头管理【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本文是 knowledge-work-plugins 仓库中 video-advanced.md 的深度实战指南聚焦 Zoom Windows Meeting SDK 的IMeetingVideoController提供的三个 Level 3 子 Helper远程摄像头 PTZ 控制、画廊视图批量视频排序与本地摄像头设备管理。阅读本文后你将掌握完整的导航路径、事务式批量排序模式、权限请求/回调链路以及可直接落地的 C 完整示例代码。概览三个 Level 3 子 HelperIMeetingVideoController是会议视频域的总控制器Singleton它向下派生了三个用于高级视频操作的 Level 3 子 HelperHelperGetter平台用途IMeetingCameraHelperGetMeetingCameraHelper(userid)跨平台远程 PTZ 摄像头控制平移/倾斜/变焦ISetVideoOrderHelperGetSetVideoOrderHelper()仅 Windows画廊视图中批量设置视频顺序ICameraControllerGetMyCameraController()仅 Windows控制本地摄像头设备从 singleton-hierarchy.md 的完整服务树可以看到这三个 Helper 均位于 Level 2 控制器IMeetingVideoController之下、属于 [LEAF] 叶子节点。其中IMeetingCameraHelper是跨平台能力而ISetVideoOrderHelper与ICameraController是 Windows 专属能力在 Windows 平台开发时要注意用#if defined(WIN32)宏保护参见 SKILL.md 中关于 Windows-only 控制器的平台可用性说明。导航路径从 IMeetingService 到视频高级能力SDK 采用服务定位器模式Service Locator你不需要自行构造对象而是沿着单例树逐层导航。视频高级功能的完整导航路径如下IMeetingService └─► GetMeetingVideoController() ├─► GetMeetingCameraHelper(userid) // 远程摄像头 PTZ 控制跨平台 ├─► GetSetVideoOrderHelper() // 画廊视频顺序仅 Windows └─► GetMyCameraController() // 本地摄像头设备仅 Windows这一路径遵循仓库中反复强调的通用三步模式见 sdk-architecture-pattern.md获取控制器/Helper单例模式meetingService-GetMeetingVideoController()实现事件监听接口观察者模式继承IMeetingVideoCtrlEvent并实现全部纯虚方法注册监听并使用videoCtrl-SetEvent(listener)后调用控制方法。实践要点控制器在未进入会议时返回nullptr且加入/离开会议后旧指针可能失效。因此应在MEETING_STATUS_INMEETING回调之后重新获取控制器并始终检查nullptr详见 singleton-hierarchy.md 的Practical Rules。一、远程摄像头控制IMeetingCameraHelper跨平台IMeetingCameraHelper用于控制已授予权限的远端参会者的 PTZPan-Tilt-Zoom摄像头典型场景包括远程课堂、手术示教、监控直播等需要远端视角调整的应用。1.1 获取 Helper// Get video controller first IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; // Get camera helper for specific user unsigned int targetUserId 12345; IMeetingCameraHelper* cameraHelper videoCtrl-GetMeetingCameraHelper(targetUserId); if (!cameraHelper) { // User doesnt exist or doesnt have controllable camera return; }注意GetMeetingCameraHelper(userid)需要传入目标用户 ID且返回nullptr可能意味着用户不存在或对方没有可控制的摄像头。1.2 检查可控制性并请求控制获取 Helper 后先通过CanControlCamera()判断是否已具备控制权若未具备则需要通过RequestControlRemoteCamera()发起控制请求并等待回调确认权限授予——请求是异步的不能立即操作摄像头// Check if we can control this users camera if (!cameraHelper-CanControlCamera()) { // Need to request control first SDKError err cameraHelper-RequestControlRemoteCamera(); if (err ! SDKERR_SUCCESS) { // Request failed - user may not have PTZ camera } // Wait for callback to confirm permission granted return; }1.3 摄像头移动操作// All movement methods accept range 10-100 (default: 50) // Higher faster/larger movement // Pan left/right cameraHelper-TurnLeft(50); // Pan left cameraHelper-TurnRight(50); // Pan right // Tilt up/down cameraHelper-TurnUp(50); // Tilt up cameraHelper-TurnDown(50); // Tilt down // Zoom in/out cameraHelper-ZoomIn(50); // Zoom in cameraHelper-ZoomOut(50); // Zoom out所有移动方法的参数范围均为 10–100默认值为 50数值越大表示移动/变焦速度越快或幅度越大。实际控制时建议由小到大渐进调整避免画面大幅跳动。1.4 释放控制// When done controlling cameraHelper-GiveUpControlRemoteCamera();控制完成后务必调用GiveUpControlRemoteCamera()主动释放避免长期占用远端摄像头的控制权。1.5 处理摄像头控制请求事件回调作为被控制方或请求方都需要通过继承IMeetingVideoCtrlEvent的监听器来处理两类回调onCameraControlRequestReceived对方请求控制我们的摄像头被控制方视角通过ICameraControlRequestHandler的Approve()/Decline()决定是否批准onCameraControlRequestResult我们发起的控制请求的结果请求方视角区分Approve/Decline/Revoke三种结果。class MyCameraEventHandler : public IMeetingVideoCtrlEvent { public: void onCameraControlRequestReceived( unsigned int userId, CameraControlRequestType requestType, ICameraControlRequestHandler* pHandler) override { if (requestType CameraControlRequestType_RequestControl) { // Someone wants to control our camera // Approve or decline pHandler-Approve(); // or pHandler-Decline(); } else if (requestType CameraControlRequestType_GiveUpControl) { // User released control of our camera } } void onCameraControlRequestResult( unsigned int userId, CameraControlRequestResult result) override { switch (result) { case CameraControlRequestResult_Approve: // Our request was approved - can now control camera break; case CameraControlRequestResult_Decline: // Our request was declined break; case CameraControlRequestResult_Revoke: // Our control was revoked break; } } // ... other callback implementations };接口完整性提醒IMeetingVideoCtrlEvent是一组纯虚接口漏实现任何一个都会导致 C2259 cannot instantiate abstract class 编译错误。仓库 interface-methods.md 明确要求实现所有纯虚方法包括#if defined(WIN32)内的平台专属方法不需要的方法实现为空桩即可。二、画廊视图视频排序ISetVideoOrderHelper仅 WindowsISetVideoOrderHelper用于在画廊视图Gallery View中批量设置参会者视频的顺序适合需要把特定人员如主持人、讲师、翻译固定到特定位置的场景。2.1 获取 Helper#if defined(WIN32) IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; ISetVideoOrderHelper* orderHelper videoCtrl-GetSetVideoOrderHelper(); if (!orderHelper) return; #endif2.2 事务模式批量排序Transaction Pattern与仓库中IBatchCreateBOHelper的批量创建会议室见 singleton-hierarchy.md 的 Level 4 批量操作示例采用相同的事务三段式设计——Begin → Add → Commit#if defined(WIN32) // Step 1: Begin transaction (clears any previous prepared order) SDKError err orderHelper-SetVideoOrderTransactionBegin(); if (err ! SDKERR_SUCCESS) return; // Step 2: Add users to positions (0-based, max 49 positions) // Position 0 first slot in gallery orderHelper-AddVideoToOrder(hostUserId, 0); // Host at position 0 orderHelper-AddVideoToOrder(presenter1Id, 1); // Presenter at position 1 orderHelper-AddVideoToOrder(presenter2Id, 2); // Another presenter at position 2 // ... add more as needed // Step 3: Commit the transaction err orderHelper-SetVideoOrderTransactionCommit(); if (err ! SDKERR_SUCCESS) { // Commit failed } #endif位置编号从 0 开始AddVideoToOrder(userId, position)把指定用户放置到画廊的指定槽位。2.3 重要注意事项最多可排序 49 个用户若同一位置被分配给多个用户只有最后添加的一个生效添加用户前必须先调用SetVideoOrderTransactionBegin()开启事务该调用会清空此前准备的顺序只有主持人/联席主持人host/co-host能为所有参会者设置视频顺序可使用EnableFollowHostVideoOrder()让参会者跟随主持人的视频顺序。2.4 跟随主持人视频顺序Follow Host Video Order// Check if feature is supported if (videoCtrl-IsSupportFollowHostVideoOrder()) { // Enable following hosts video order videoCtrl-EnableFollowHostVideoOrder(true); // Check if currently following bool isFollowing videoCtrl-IsFollowHostVideoOrderOn(); } // Get current video order list IListunsigned int* orderList videoCtrl-GetVideoOrderList(); if (orderList) { for (int i 0; i orderList-GetCount(); i) { unsigned int userId orderList-GetItem(i); // Process ordered user IDs } }GetVideoOrderList()返回当前顺序的用户 ID 列表IListunsigned int可通过GetCount()/GetItem(i)遍历。使用前先通过IsSupportFollowHostVideoOrder()探测当前 SDK 版本是否支持该能力是稳妥的做法仓库 sdk-architecture-pattern.md 中Check Availability Before Use模式同样适用于这里。三、本地摄像头设备控制ICameraController仅 WindowsICameraController用于控制本地用户的摄像头设备设置例如切换设备、调整设备参数等#if defined(WIN32) IMeetingVideoController* videoCtrl meetingService-GetMeetingVideoController(); if (!videoCtrl) return; ICameraController* cameraCtrl videoCtrl-GetMyCameraController(); if (!cameraCtrl) return; // ICameraController provides device-level camera control // (Interface details depend on SDK version - check headers) #endif注意ICameraController的具体接口方法随 SDK 版本不同而存在差异接入时以你所使用 SDK 版本的meeting_service_components头文件为准仓库文档基于 Zoom Windows Meeting SDK v6.7.2.26830见 SKILL.md。SDK 头文件按功能拆分命名如meeting_[feature]_interface.h可在SDK/x64/h/meeting_service_components/目录下定位对应声明。四、视频排序回调Video Order Callbacks当主持人或其他参会者改变视频顺序时通过IMeetingVideoCtrlEvent的三个回调感知变化并同步 UIclass MyVideoEventHandler : public IMeetingVideoCtrlEvent { public: void onHostVideoOrderUpdated(IListunsigned int* orderList) override { // Host changed the video order // Update UI to reflect new order if (orderList) { for (int i 0; i orderList-GetCount(); i) { unsigned int userId orderList-GetItem(i); // Reorder video tiles accordingly } } } void onLocalVideoOrderUpdated(IListunsigned int* localOrderList) override { // Local video order changed (users personal arrangement) } void onFollowHostVideoOrderChanged(bool bFollow) override { // Following host video order setting changed if (bFollow) { // Now following hosts order } else { // Using local order } } // ... other callback implementations };三个回调分别对应三种场景回调触发时机典型处理onHostVideoOrderUpdated(orderList)主持人更新了全局视频顺序按新顺序重排视频瓦片onLocalVideoOrderUpdated(localOrderList)本地个人排列顺序变化更新本地视图onFollowHostVideoOrderChanged(bFollow)跟随主持人顺序开关变化切换跟随/本地两种布局逻辑五、完整示例摄像头控制流程管理器下面把远程摄像头控制的全流程封装为CameraControlManager类涵盖初始化、请求控制、授予后操作、释放控制以及完整的回调实现——可直接作为项目骨架class CameraControlManager : public IMeetingVideoCtrlEvent { private: IMeetingVideoController* m_videoCtrl nullptr; IMeetingCameraHelper* m_currentCameraHelper nullptr; public: void Initialize(IMeetingService* meetingService) { m_videoCtrl meetingService-GetMeetingVideoController(); if (m_videoCtrl) { m_videoCtrl-SetEvent(this); } } void RequestCameraControl(unsigned int targetUserId) { if (!m_videoCtrl) return; m_currentCameraHelper m_videoCtrl-GetMeetingCameraHelper(targetUserId); if (!m_currentCameraHelper) { // User not found or no controllable camera return; } if (m_currentCameraHelper-CanControlCamera()) { // Already have control OnCameraControlGranted(); } else { // Request control m_currentCameraHelper-RequestControlRemoteCamera(); } } void OnCameraControlGranted() { // Now can control camera // Example: Center the camera m_currentCameraHelper-TurnLeft(30); m_currentCameraHelper-TurnUp(20); } void ReleaseCameraControl() { if (m_currentCameraHelper) { m_currentCameraHelper-GiveUpControlRemoteCamera(); m_currentCameraHelper nullptr; } } // IMeetingVideoCtrlEvent implementations void onCameraControlRequestResult(unsigned int userId, CameraControlRequestResult result) override { if (result CameraControlRequestResult_Approve) { OnCameraControlGranted(); } else { m_currentCameraHelper nullptr; } } void onCameraControlRequestReceived(unsigned int userId, CameraControlRequestType requestType, ICameraControlRequestHandler* pHandler) override { // Auto-approve camera control requests if (requestType CameraControlRequestType_RequestControl) { pHandler-Approve(); } } // ... implement other required callbacks void onUserVideoStatusChange(unsigned int userId, VideoStatus status) override {} void onSpotlightedUserListChangeNotification(IListunsigned int* lst) override {} void onHostRequestStartVideo(IRequestStartVideoHandler* handler) override {} void onActiveSpeakerVideoUserChanged(unsigned int userid) override {} void onActiveVideoUserChanged(unsigned int userid) override {} void onHostVideoOrderUpdated(IListunsigned int* orderList) override {} void onLocalVideoOrderUpdated(IListunsigned int* localOrderList) override {} void onFollowHostVideoOrderChanged(bool bFollow) override {} void onUserVideoQualityChanged(VideoConnectionQuality quality, unsigned int userid) override {} void onVideoAlphaChannelStatusChanged(bool isAlphaModeOn) override {} };代码中的关键设计点Initialize()统一注册监听通过videoCtrl-SetEvent(this)注册事件之后所有摄像头与视频排序回调都会路由到该类请求控制后由回调驱动RequestControlRemoteCamera()是异步的真正开始操作是在onCameraControlRequestResult收到Approve之后通过OnCameraControlGranted()触发空桩实现保证编译通过其余IMeetingVideoCtrlEvent纯虚方法均以空实现补齐避免抽象类实例化错误释放后置空指针GiveUpControlRemoteCamera()后立即将m_currentCameraHelper置空防止悬垂指针。集成前置条件消息循环、头文件顺序与平台宏仓库 SKILL.md 强调接入以上任何视频功能前必须满足三个前提1. Windows 消息循环回调不触发的头号原因SDK 通过 Windows 消息泵派发异步回调。没有消息循环回调只会入队而永远不被执行——表现为权限请求永远得不到结果、排序回调不触发。主循环示例MSG msg; while (!g_exit) { while (PeekMessage(msg, NULL, 0, 0, PM_REMOVE)) { if (msg.message WM_QUIT) { g_exit true; break; } TranslateMessage(msg); DispatchMessage(msg); } std::this_thread::sleep_for(std::chrono::milliseconds(100)); }2. 头文件包含顺序#include windows.h // MUST be first #include cstdint // MUST be second (SDK headers use uint32_t) // ... other standard headers ... #include zoom_sdk.h #include meeting_service_components/meeting_audio_interface.h // BEFORE participants! #include meeting_service_components/meeting_participants_ctrl_interface.h视频控制器相关头文件meeting_video_interface.h等遵循同样的包含顺序约束。3. Windows 专属接口的平台保护ISetVideoOrderHelper与ICameraController仅存在于 Windows 平台。若应用需要跨平台编译必须将相关调用包裹在#if defined(WIN32)中避免在其他平台出现编译错误。相关文档singleton-hierarchy.md —— SDK 完整服务树导航图视频域三个 Level 3 Helper 的层级定位sdk-architecture-pattern.md —— 适用于全部 35 控制器的通用三步实现模式SKILL.md —— Windows Meeting SDK 总览、工程配置与快速上手interface-methods.md —— 事件监听接口全部纯虚方法的实现规范windows-reference.md —— Visual Studio 工程配置、SDKError 错误码与常见问题排查仓库基于 Zoom Windows Meeting SDK v6.7.2.26830 编写不同 SDK 版本的接口方法与枚举可能存在差异请以实际使用的 SDK 头文件为准。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考