Zoom Meeting SDK Windows
AnthropicOfficialCreated by ZoomDistributed by Anthropic
- Skill
- Tool integration
- Software development
- MIT
- Low risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The Zoom Meeting SDK for Windows provides a native C++ interface for embedding Zoom meeting functionality directly into desktop applications. It supports a wide range of use cases, from building custom meeting UIs to creating headless bots for automated tasks. The SDK utilizes a controller-based architecture where developers implement event listeners to handle meeting lifecycle events, audio/video streams, and other features. Proper integration requires careful management of the Windows message loop to ensure callbacks are processed correctly and adherence to specific project structure guidelines.
What it does
- Enables embedding Zoom meetings within native Windows desktop applications.
- Supports headless bot development for automated meeting participation.
- Provides access to raw audio and video data streams for custom processing.
- Offers a consistent controller-based pattern for accessing 35+ meeting features.
- Allows for custom UI rendering or standard SDK-provided interfaces.
- Facilitates local recording and advanced meeting management controls.
When to use it
- When building a custom Windows desktop application that requires integrated video conferencing.
- When developing automated bots that need to join Zoom meetings to perform tasks.
- When you need low-level access to raw audio/video frames from a Zoom meeting.
- When you need to build a custom meeting interface that deviates from the standard Zoom client UI.
Advantages
- Native C++ performance for resource-intensive media processing.
- Full control over the meeting UI and user experience.
- Universal architecture pattern simplifies implementing diverse features.
- Supports both UI-based applications and headless background services.
Usage examples
- “How do I initialize the Zoom Meeting SDK in my C++ Windows application?”
- You must create an InitParam object, configure the web domain and language settings, and call the InitSDK function, ensuring you handle the return status for success.
- “Why are my Zoom SDK callbacks not firing in my Windows app?”
- This is typically caused by a missing Windows message loop. You must implement a PeekMessage/DispatchMessage loop to allow the SDK to process asynchronous callbacks.
- “How can I capture raw video from a meeting participant?”
- You must start raw recording, create an IZoomSDKRenderer, and subscribe to the specific user's video stream using the renderer, then implement the IZoomSDKRendererDelegate to receive frames.
- “What is the recommended project structure for a Zoom SDK Windows app?”
- Use a native Visual Studio .vcxproj project, organize SDK files into x64/x86 subdirectories, and ensure your config.json is included in the project for easy access.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/anthropics/zoom-meeting-sdk-windows/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip zoom-meeting-sdk-windows.zip -d .agents/skills
Documentation by Zoom
Zoom Meeting SDK (Windows)
Embed Zoom meeting capabilities into Windows desktop applications for native C++ integrations and headless bots.
New to Zoom SDK? Start Here!
The fastest way to master the SDK:
SDK Architecture Pattern - Learn the universal pattern that works for ALL 35+ features
Authentication Pattern - Get a working bot joining meetings
Windows Message Loop - Fix the #1 reason callbacks don't fire
Building a Custom UI?
Custom UI Architecture - How SDK rendering actually works (child HWNDs, D3D, etc.)
Custom UI Video Rendering Example - Complete working code
SDK-Rendered vs Self-Rendered - Choose the right approach
Custom UI Interface Methods - All 13 required virtual methods
Having issues?
Build errors → Build Errors Guide
Callbacks not firing → Windows Message Loop
Quick diagnostics → Common Issues
Performance / service quality → service-quality.md
Deployment notes → deployment.md
MSBuild from git bash → Build Errors Guide
Complete navigation → SKILL.md
Prerequisites
Zoom app with Meeting SDK credentials (Client ID & Secret)
Visual Studio 2019/2022 or later
Windows 10 or later
C++ development environment
vcpkg for dependency management
Need help with authentication? See the zoom-oauth skill for JWT token generation.
Project Preferences & Learnings
IMPORTANT: These are hard-won preferences from real project experience. Follow these when creating new projects.
Do NOT use CMake — Use native Visual Studio .vcxproj
Always create a native Visual Studio .sln + .vcxproj project, not a CMake project. Reasons:
More standard and familiar for Windows C++ developers
Developers can double-click the
.slnto open in Visual Studio immediatelyProject settings (include dirs, lib dirs, preprocessor defines) are easier to see and edit in the VS Property Pages UI
No extra CMake tooling or configuration step required
Friendlier and easier for developers to understand and maintain
config.json must be visible in Solution Explorer
The config.json file (containing sdk_jwt, meeting_number, passcode) must be:
Included in the
.vcxprojas a<None>item with<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>Placed in a "Config" filter in the
.vcxproj.filtersfile so it appears under a "Config" folder in Solution ExplorerEasily editable by developers directly from Solution Explorer — they should never have to hunt for it in File Explorer
Example .vcxproj entry:
<ItemGroup>
<None Include="config.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
</ItemGroup>Example .vcxproj.filters entry:
<ItemGroup>
<Filter Include="Config">
<UniqueIdentifier>{GUID-HERE}</UniqueIdentifier>
</Filter>
</ItemGroup>
<ItemGroup>
<None Include="config.json">
<Filter>Config</Filter>
</None>
</ItemGroup>Overview
The Windows SDK is a C++ native SDK designed for:
Desktop applications - Native Windows apps with full UI control
Headless bots - Join meetings without UI
Raw media access - Capture/send audio/video streams
Local recording - Record meetings locally or to cloud
Key Architectural Insight
The SDK follows a universal 3-step pattern for every feature:
Get controller (singleton):
meetingService->Get[Feature]Controller()Implement event listener:
class MyListener : public I[Feature]Event { ... }Register and use:
controller->SetEvent(listener)then call methods
This works for ALL features: audio, video, chat, recording, participants, screen sharing, breakout rooms, webinars, Q&A, polling, whiteboard, and 20+ more!
Learn more: SDK Architecture Pattern Guide
Quick Start
1. Download Windows SDK
Download from Zoom Marketplace:
Extract
zoom-meeting-sdk-windows_x86_64-{version}.zip
2. Setup Project Structure
your-project/
YourApp/
SDK/
x64/
bin/ # DLL files and dependencies
h/ # Header files
lib/ # sdk.lib
x86/
bin/
h/
lib/
YourApp.cpp
YourApp.vcxproj
config.jsonCopy SDK files:
xcopy /E /I sdk-package\x64 your-project\YourApp\SDK\x64\
xcopy /E /I sdk-package\x86 your-project\YourApp\SDK\x86\3. Install Dependencies (vcpkg)
# Install vcpkg
git clone https://github.com/Microsoft/vcpkg.git C:\vcpkg
cd C:\vcpkg
.\bootstrap-vcpkg.bat
.\vcpkg integrate install
# Install dependencies
.\vcpkg install jsoncpp:x64-windows
.\vcpkg install curl:x64-windows4. Configure Visual Studio Project
Project Properties → C/C++ → General → Additional Include Directories:
$(SolutionDir)SDK\$(PlatformTarget)\h
C:\vcpkg\packages\jsoncpp_x64-windows\include
C:\vcpkg\packages\curl_x64-windows\includeProject Properties → Linker → General → Additional Library Directories:
$(SolutionDir)SDK\$(PlatformTarget)\libProject Properties → Linker → Input → Additional Dependencies:
sdk.libPost-Build Event (Copy DLLs to output):
xcopy /Y /D "$(SolutionDir)SDK\$(PlatformTarget)\bin\*.*" "$(OutDir)"5. Configure Credentials
Create config.json:
{
"sdk_jwt": "YOUR_JWT_TOKEN",
"meeting_number": "1234567890",
"passcode": "password123",
"zak": ""
}6. Build & Run
Open solution in Visual Studio
Select x64 or x86 configuration
Press F5 to build and run
Core Workflow
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ InitSDK │───►│ AuthSDK │───►│ JoinMeeting │───►│ Raw Data │
│ │ │ (JWT) │ │ │ │ Subscribe │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│ │
▼ ▼
OnAuthComplete onInMeeting
callback callback⚠️ CRITICAL: Add Windows message loop or callbacks won't fire!
while (!done) {
MSG msg;
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}See: Windows Message Loop Guide
Code Examples
💡 Pro Tip: These are minimal examples. For complete, tested code see:
Authentication Pattern - Full auth workflow
Raw Video Capture - Complete video capture
SDK Architecture Pattern - Implement any feature
Important: Include Order
CRITICAL: Include headers in this exact order or you'll get build errors:
#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>See: Build Errors Guide for all dependency fixes.
1. Initialize SDK
#include <windows.h>
#include <cstdint>
#include <zoom_sdk.h>
using namespace ZOOM_SDK_NAMESPACE;
bool InitMeetingSDK() {
InitParam initParam;
initParam.strWebDomain = L"https://zoom.us";
initParam.strSupportUrl = L"https://zoom.us";
initParam.emLanguageID = LANGUAGE_English;
initParam.enableLogByDefault = true;
initParam.enableGenerateDump = true;
SDKError err = InitSDK(initParam);
if (err != SDKERR_SUCCESS) {
std::wcout << L"InitSDK failed: " << err << std::endl;
return false;
}
return true;
}2. Authenticate with JWT
#include <windows.h>
#include <cstdint>
#include <auth_service_interface.h>
#include "AuthServiceEventListener.h"
IAuthService* authService = nullptr;
void OnAuthenticationComplete() {
std::cout << "Authentication successful!" << std::endl;
JoinMeeting(); // Proceed to join meeting
}
bool AuthenticateSDK(const std::wstring& jwtToken) {
CreateAuthService(&authService);
if (!authService) return false;
// Set event listener BEFORE calling SDKAuth
authService->SetEvent(new AuthServiceEventListener(&OnAuthenticationComplete));
// Authenticate with JWT
AuthContext authContext;
authContext.jwt_token = jwtToken.c_str();
SDKError err = authService->SDKAuth(authContext);
if (err != SDKERR_SUCCESS) {
std::wcout << L"SDKAuth failed: " << err << std::endl;
return false;
}
// CRITICAL: Add message loop or callback won't fire!
// See complete example: examples/authentication-pattern.md
return true;
}AuthServiceEventListener.h:
#include <windows.h>
#include <cstdint>
#include <auth_service_interface.h>
#include <iostream>
using namespace ZOOM_SDK_NAMESPACE;
class AuthServiceEventListener : public IAuthServiceEvent {
public:
AuthServiceEventListener(void (*onComplete)())
: onAuthComplete(onComplete) {}
void onAuthenticationReturn(AuthResult ret) override {
if (ret == AUTHRET_SUCCESS && onAuthComplete) {
onAuthComplete();
} else {
std::cout << "Auth failed: " << ret << std::endl;
}
}
// Must implement ALL pure virtual methods (6 total)
void onLoginReturnWithReason(LOGINSTATUS ret, IAccountInfo* info, LoginFailReason reason) override {}
void onLogout() override {}
void onZoomIdentityExpired() override {}
void onZoomAuthIdentityExpired() override {}
#if defined(WIN32)
void onNotificationServiceStatus(SDKNotificationServiceStatus status, SDKNotificationServiceError error) override {}
#endif
private:
void (*onAuthComplete)();
};See complete working code: Authentication Pattern Guide
3. Join Meeting
#include <meeting_service_interface.h>
#include "MeetingServiceEventListener.h"
IMeetingService* meetingService = nullptr;
void OnMeetingJoined() {
std::cout << "Joining meeting..." << std::endl;
}
void OnInMeeting() {
std::cout << "In meeting now!" << std::endl;
// Start raw data capture here
}
void OnMeetingEnds() {
std::cout << "Meeting ended" << std::endl;
}
bool JoinMeeting(UINT64 meetingNumber, const std::wstring& password) {
CreateMeetingService(&meetingService);
if (!meetingService) return false;
// Set event listener
meetingService->SetEvent(
new MeetingServiceEventListener(&OnMeetingJoined, &OnMeetingEnds, &OnInMeeting)
);
// Prepare join parameters
JoinParam joinParam;
joinParam.userType = SDK_UT_WITHOUT_LOGIN;
JoinParam4WithoutLogin& params = joinParam.param.withoutloginuserJoin;
params.meetingNumber = meetingNumber;
params.userName = L"Bot User";
params.psw = password.c_str();
params.isVideoOff = false;
params.isAudioOff = false;
SDKError err = meetingService->Join(joinParam);
if (err != SDKERR_SUCCESS) {
std::wcout << L"Join failed: " << err << std::endl;
return false;
}
return true;
}MeetingServiceEventListener.h:
#include <windows.h>
#include <cstdint>
#include <meeting_service_interface.h>
#include <iostream>
using namespace ZOOM_SDK_NAMESPACE;
class MeetingServiceEventListener : public IMeetingServiceEvent {
public:
MeetingServiceEventListener(
void (*onJoined)(),
void (*onEnded)(),
void (*onInMeeting)()
) : onMeetingJoined(onJoined),
onMeetingEnded(onEnded),
onInMeetingCallback(onInMeeting) {}
void onMeetingStatusChanged(MeetingStatus status, int iResult) override {
if (status == MEETING_STATUS_CONNECTING) {
if (onMeetingJoined) onMeetingJoined();
}
else if (status == MEETING_STATUS_INMEETING) {
if (onInMeetingCallback) onInMeetingCallback();
}
else if (status == MEETING_STATUS_ENDED) {
if (onMeetingEnded) onMeetingEnded();
}
}
// Must implement ALL pure virtual methods (9 total)
void onMeetingStatisticsWarningNotification(StatisticsWarningType type) override {}
void onMeetingParameterNotification(const MeetingParameter* param) override {}
void onSuspendParticipantsActivities() override {}
void onAICompanionActiveChangeNotice(bool isActive) override {}
void onMeetingTopicChanged(const zchar_t* sTopic) override {}
void onMeetingFullToWatchLiveStream(const zchar_t* sLiveStreamUrl) override {}
void onUserNetworkStatusChanged(MeetingComponentType type, ConnectionQuality level, unsigned int userId, bool uplink) override {}
#if defined(WIN32)
void onAppSignalPanelUpdated(IMeetingAppSignalHandler* pHandler) override {}
#endif
private:
void (*onMeetingJoined)();
void (*onMeetingEnded)();
void (*onInMeetingCallback)();
};See all required methods: Interface Methods Guide
4. Subscribe to Raw Video
#include <windows.h>
#include <cstdint>
#include <rawdata/zoom_rawdata_api.h>
#include <rawdata/rawdata_renderer_interface.h>
#include <zoom_sdk_raw_data_def.h> // REQUIRED for YUVRawDataI420
#include "ZoomSDKRendererDelegate.h"
IZoomSDKRenderer* videoHelper = nullptr;
ZoomSDKRendererDelegate* videoSource = new ZoomSDKRendererDelegate();
bool StartVideoCapture(uint32_t userId) {
// STEP 1: Start raw recording FIRST (required!)
IMeetingRecordingController* recordCtrl =
meetingService->GetMeetingRecordingController();
SDKError canStart = recordCtrl->CanStartRawRecording();
if (canStart != SDKERR_SUCCESS) {
std::cout << "Cannot start recording: " << canStart << std::endl;
return false;
}
recordCtrl->StartRawRecording();
// Wait for recording to initialize
std::this_thread::sleep_for(std::chrono::milliseconds(500));
// STEP 2: Create renderer
SDKError err = createRenderer(&videoHelper, videoSource);
if (err != SDKERR_SUCCESS || !videoHelper) {
std::cout << "createRenderer failed: " << err << std::endl;
return false;
}
// STEP 3: Set resolution and subscribe
videoHelper->setRawDataResolution(ZoomSDKResolution_720P);
err = videoHelper->subscribe(userId, RAW_DATA_TYPE_VIDEO);
if (err != SDKERR_SUCCESS) {
std::cout << "Subscribe failed: " << err << std::endl;
return false;
}
std::cout << "Video capture started! Frames arrive in onRawDataFrameReceived()" << std::endl;
return true;
}ZoomSDKRendererDelegate.h:
#include <windows.h>
#include <cstdint>
#include <rawdata/rawdata_renderer_interface.h>
#include <zoom_sdk_raw_data_def.h>
#include <fstream>
#include <iostream>
using namespace ZOOM_SDK_NAMESPACE;
class ZoomSDKRendererDelegate : public IZoomSDKRendererDelegate {
public:
void onRawDataFrameReceived(YUVRawDataI420* data) override {
if (!data) return;
// YUV420 (I420) format: Y plane + U plane + V plane
int width = data->GetStreamWidth();
int height = data->GetStreamHeight();
// Calculate buffer sizes
// Y = full resolution, U/V = quarter resolution each
size_t ySize = width * height;
size_t uvSize = ySize / 4; // (width/2) * (height/2)
// Total size: width * height * 1.5 bytes
// Save to file (playback: ffplay -f rawvideo -pixel_format yuv420p -video_size 1280x720 output.yuv)
std::ofstream outputFile("output.yuv", std::ios::binary | std::ios::app);
outputFile.write(data->GetYBuffer(), ySize); // Brightness
outputFile.write(data->GetUBuffer(), uvSize); // Blue-difference
outputFile.write(data->GetVBuffer(), uvSize); // Red-difference
outputFile.close();
}
void onRawDataStatusChanged(RawDataStatus status) override {
std::cout << "Raw data status: " << status << std::endl;
}
void onRendererBeDestroyed() override {
std::cout << "Renderer destroyed" << std::endl;
}
};Complete video capture guide: Raw Video Capture Guide
5. Subscribe to Raw Audio
#include <rawdata/rawdata_audio_helper_interface.h>
class ZoomSDKAudioRawDataDelegate : public IZoomSDKAudioRawDataDelegate {
public:
void onMixedAudioRawDataReceived(AudioRawData* data) override {
// Process PCM audio (mixed from all participants)
std::ofstream pcmFile("audio.pcm", std::ios::binary | std::ios::app);
pcmFile.write((char*)data->GetBuffer(), data->GetBufferLen());
pcmFile.close();
}
void onOneWayAudioRawDataReceived(AudioRawData* data, uint32_t node_id) override {
// Process audio from specific participant
}
};
// Subscribe to audio
IZoomSDKAudioRawDataHelper* audioHelper = GetAudioRawdataHelper();
audioHelper->subscribe(new ZoomSDKAudioRawDataDelegate());6. Main Message Loop (CRITICAL!)
⚠️ WITHOUT THIS, CALLBACKS WON'T FIRE!
#include <windows.h>
#include <thread>
#include <chrono>
int main() {
// Initialize COM
CoInitialize(NULL);
// Load config and initialize
LoadConfig();
InitMeetingSDK();
AuthenticateSDK(sdk_jwt);
// CRITICAL: Windows message loop for SDK callbacks
// SDK uses Windows message pump to dispatch callbacks
// Without this, callbacks are queued but NEVER fire!
MSG msg;
while (!g_exit) {
// Process all pending Windows messages
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
if (msg.message == WM_QUIT) {
g_exit = true;
break;
}
TranslateMessage(&msg);
DispatchMessage(&msg);
}
// Small sleep to avoid busy-waiting
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
// Cleanup
CleanSDK();
CoUninitialize();
return 0;
}Why message loop is critical: The SDK uses Windows COM/messaging for async callbacks. Without PeekMessage(), the SDK queues messages but they're never retrieved/dispatched, so callbacks never execute.
Symptoms without message loop:
Authentication timeout (even with valid JWT)
Meeting join timeout
No callback events fire
Appears like network/auth issue but it's a message loop issue
See detailed explanation: Windows Message Loop Guide
Common Issues & Solutions
| Issue | Solution |
|---|---|
| Callbacks don't fire / Auth timeout | Add Windows message loop → Guide |
uint32_t / AudioType errors | Fix include order → Guide |
| Abstract class error | Implement all virtual methods → Guide |
| How to implement [feature]? | Follow universal pattern → Guide |
| Authentication fails | Check JWT token & error codes → Guide |
| No video frames received | Call StartRawRecording() first → Guide |
Complete troubleshooting: Common Issues Guide
How to Implement Any Feature
The SDK has 35+ feature controllers (audio, video, chat, recording, participants, screen sharing, breakout rooms, webinars, Q&A, polling, whiteboard, captions, AI companion, etc.).
Universal pattern that works for ALL features:
Get the controller (singleton):
IMeetingAudioController* audioCtrl = meetingService->GetMeetingAudioController(); IMeetingChatController* chatCtrl = meetingService->GetMeetingChatController(); // ... 33 more controllers availableImplement event listener (observer pattern):
class MyAudioListener : public IMeetingAudioCtrlEvent { void onUserAudioStatusChange(IList<IUserAudioStatus*>* lst) override { // React to audio events } // ... implement all required methods };Register and use:
audioCtrl->SetEvent(new MyAudioListener()); audioCtrl->MuteAudio(userId, true); // Use feature
Complete guide with examples: SDK Architecture Pattern
Available Examples
| Example | Description |
|---|---|
| SkeletonDemo | Minimal join meeting - start here |
| GetVideoRawData | Subscribe to raw video streams |
| GetAudioRawData | Subscribe to raw audio streams |
| SendVideoRawData | Send custom video as virtual camera |
| SendAudioRawData | Send custom audio as virtual mic |
| GetShareRawData | Capture screen share content |
| LocalRecording | Local MP4 recording |
| ChatDemo | In-meeting chat functionality |
| CaptionDemo | Closed caption/live transcription |
| BreakoutDemo | Breakout room management |
Detailed References
🎯 Core Concepts (START HERE!)
concepts/sdk-architecture-pattern.md - Universal pattern for implementing ANY feature - Understanding this unlocks the entire SDK!
📚 Complete Examples
examples/authentication-pattern.md - Complete working authentication with JWT tokens
examples/raw-video-capture.md - YUV420 video capture with detailed format explanation
🔧 Troubleshooting Guides
troubleshooting/windows-message-loop.md - Why callbacks don't fire (MOST CRITICAL!)
troubleshooting/build-errors.md - SDK header dependency issues and fixes
troubleshooting/common-issues.md - Quick diagnostic workflow and error code tables
📖 References
references/interface-methods.md - How to implement ALL required virtual methods
references/windows-reference.md - Dependencies, Visual Studio setup
../references/authorization.md - SDK JWT generation
../references/bot-authentication.md - Bot token types (ZAK, OBF, JWT)
🎨 Feature-Specific Guides
../references/breakout-rooms.md - Programmatic breakout room management
../references/ai-companion.md - AI Companion controls
Sample Repositories
| Repository | Description |
|---|---|
| meetingsdk-windows-raw-recording-sample | Official raw data capture samples |
| meetingsdk-windows-local-recording-sample | Local recording with Docker |
Playing Raw Video/Audio Files
Raw YUV/PCM files have no headers - you must specify format explicitly.
Play Raw YUV Video
ffplay -video_size 1280x720 -pixel_format yuv420p -f rawvideo output.yuvConvert YUV to MP4
ffmpeg -video_size 1280x720 -pixel_format yuv420p -f rawvideo -i output.yuv -c:v libx264 output.mp4Play Raw PCM Audio
ffplay -f s16le -ar 32000 -ac 1 audio.pcmConvert PCM to WAV
ffmpeg -f s16le -ar 32000 -ac 1 -i audio.pcm output.wavCombine Video + Audio
ffmpeg -video_size 1280x720 -pixel_format yuv420p -f rawvideo -i output.yuv ^
-f s16le -ar 32000 -ac 1 -i audio.pcm ^
-c:v libx264 -c:a aac -shortest output.mp4Key flags:
| Flag | Description |
|---|---|
-video_size WxH | Frame dimensions (e.g., 1280x720) |
-pixel_format yuv420p | I420/YUV420 planar format |
-f rawvideo | Raw video input (no container) |
-f s16le | Signed 16-bit little-endian PCM |
-ar 32000 | Sample rate (Zoom uses 32kHz) |
-ac 1 | Mono (use -ac 2 for stereo) |
Authentication Requirements (2026 Update)
Important: Beginning March 2, 2026, apps joining meetings outside their account must be authorized.
Use one of:
App Privilege Token (OBF) - Recommended for bots (
app_privilege_tokenin JoinParam)ZAK Token - Zoom Access Key (
userZAKin JoinParam)On Behalf Token - For specific use cases (
onBehalfTokenin JoinParam)
📖 Complete Documentation Library
This skill includes comprehensive guides created from real-world debugging:
🎯 Start Here
SDK Architecture Pattern - Master document: Universal pattern for ANY feature
SKILL.md - Complete navigation guide
📚 By Category
Core Concepts:
SDK Architecture Pattern - How every feature works (singleton + observer pattern)
Complete Examples:
Authentication Pattern - Working JWT auth with all code
Raw Video Capture - YUV420 video capture explained
Troubleshooting:
Windows Message Loop - CRITICAL: Why callbacks don't fire
Build Errors - SDK header dependency fixes
Common Issues - Quick diagnostics & error codes
References:
Interface Methods - All required virtual methods (6 auth + 9 meeting)
Windows Reference - Platform setup
Authorization - JWT generation
Bot Authentication - Bot token types
Breakout Rooms - Breakout room API
AI Companion - AI features
🚨 Most Critical Issues (From Real Debugging)
Callbacks not firing → Missing Windows message loop (99% of issues)
Build errors → SDK header dependencies (
uint32_t,AudioType, etc.)See: Build Errors Guide
Abstract class errors → Missing virtual method implementations
💡 Key Insight
Once you learn the 3-step pattern, you can implement ANY of the 35+ features:
Get controller → 2. Implement event listener → 3. Register and use
Official Resources
Official docs: https://developers.zoom.us/docs/meeting-sdk/windows/
API Reference: https://marketplacefront.zoom.us/sdk/meeting/windows/annotated.html
Developer forum: https://devforum.zoom.us/
SDK download: https://marketplace.zoom.us/
Documentation Version: Based on Zoom Windows Meeting SDK v6.7.2.26830
Need help? Start with SKILL.md for complete navigation.
Merged from meeting-sdk/windows/SKILL.md
Zoom Windows Meeting SDK - Complete Documentation Index
🚀 Quick Start Path
If you're new to the SDK, follow this order:
Read the architecture pattern → concepts/sdk-architecture-pattern.md
This teaches you the universal formula that applies to ALL features
Once you understand this, you can implement any feature by reading the
.hfiles
Fix build errors → troubleshooting/build-errors.md
SDK header dependencies issues
Required include order
Implement authentication → examples/authentication-pattern.md
Complete working JWT authentication code
Fix callback issues → troubleshooting/windows-message-loop.md
CRITICAL: Why callbacks don't fire without Windows message loop
This was the hardest issue to diagnose!
Implement virtual methods → references/interface-methods.md
Complete lists of all required methods
How to avoid abstract class errors
Capture video (optional) → examples/raw-video-capture.md
YUV420 format explained
Complete raw data capture workflow
Troubleshoot any issues → troubleshooting/common-issues.md
Quick diagnostic checklist
Error code tables
"If you see X, do Y" reference
📂 Documentation Structure
meeting-sdk/windows/
├── SKILL.md # Main skill overview
├── SKILL.md # This file - navigation guide
│
├── concepts/ # Core architectural patterns
│ ├── sdk-architecture-pattern.md # THE MOST IMPORTANT DOC
│ │ # Universal formula for ANY feature
│ ├── singleton-hierarchy.md # Navigation guide for SDK services
│ │ # 4-level deep service tree, when/how
│ ├── custom-ui-architecture.md # How Custom UI rendering works
│ │ # Child HWNDs, D3D, layout, events
│ └── custom-ui-vs-raw-data.md # SDK-rendered vs self-rendered
│ # Decision guide for Custom UI approach
│
├── examples/ # Complete working code
│ ├── authentication-pattern.md # JWT auth with full code
│ ├── raw-video-capture.md # Video capture with YUV420 details
│ │ # Recording vs Streaming, permissions
│ ├── custom-ui-video-rendering.md # Custom UI with video container
│ │ # Active speaker + gallery layout
│ ├── breakout-rooms.md # Complete breakout room guide
│ │ # 5 roles, create/manage/join
│ ├── chat.md # Send/receive chat messages
│ │ # Rich text, threading, file transfer
│ ├── captions-transcription.md # Live transcription & closed captions
│ │ # Multi-language translation
│ ├── local-recording.md # Local MP4 recording
│ │ # Permission flow, encoder monitoring
│ ├── share-raw-data-capture.md # Screen share raw data capture
│ │ # YUV420 frames from shared content
│ └── send-raw-data.md # Virtual camera/mic/share
│ # Send custom video/audio/share
│
├── troubleshooting/ # Problem solving guides
│ ├── windows-message-loop.md # CRITICAL - Why callbacks fail
│ ├── build-errors.md # Header dependency fixes + MSBuild
│ └── common-issues.md # Quick diagnostic workflow
│
└── references/ # Reference documentation
├── interface-methods.md # Required virtual methods
│ # Auth(6) + Meeting(9) + CustomUI(13)
├── windows-reference.md # Platform setup
├── authorization.md # JWT generation
├── bot-authentication.md # Bot token types
├── breakout-rooms.md # Breakout room features
└── ai-companion.md # AI Companion features🎯 By Use Case
I want to build a meeting bot
SDK Architecture Pattern - Understand the pattern
Authentication Pattern - Join meetings
Windows Message Loop - Fix callback issues
Interface Methods - Implement callbacks
I'm getting build errors
Build Errors Guide - SDK header dependencies
Interface Methods - Abstract class errors
Common Issues - Linker errors
I'm getting runtime errors
Windows Message Loop - Callbacks not firing
Authentication Pattern - Auth timeout
Common Issues - Error code tables
I want to build a Custom UI meeting app
Custom UI Architecture - How SDK rendering works
SDK-Rendered vs Self-Rendered - Choose your approach
Custom UI Video Rendering - Complete working code
Interface Methods - 13 Custom UI virtual methods
Build Errors Guide - MSBuild from git bash
I want to capture video/audio
Raw Video Capture - Complete video workflow
Recording vs Streaming approaches
Permission requirements (host, OAuth tokens)
Audio PCM capture
Share Raw Data Capture - Screen share capture
Subscribe to RAW_DATA_TYPE_SHARE
Handle dynamic resolution
SDK Architecture Pattern - Controller pattern
Common Issues - No frames received
I want to use breakout rooms
Breakout Rooms Guide - Complete breakout room workflow
5 roles: Creator, Admin, Data, Assistant, Attendee
Create, configure, manage, join/leave rooms
Common Issues - Breakout room error codes
I want to implement chat
Chat Guide - Send/receive messages
Rich text formatting (bold, italic, links)
Private messages and threading
File transfer events
I want to use live transcription
Captions & Transcription Guide - Live transcription
Automatic speech-to-text
Multi-language translation
Manual closed captions (host feature)
I want to record meetings
Local Recording Guide - Local MP4 recording
Permission request workflow
zTscoder.exe encoder monitoring
Gallery view vs active speaker
I want to implement a specific feature
SDK Architecture Pattern - START HERE!
Find the controller in
SDK/x64/h/meeting_service_interface.hFind the header in
SDK/x64/h/meeting_service_components/Follow the universal pattern: Get controller → Implement listener → Use methods
I want to understand the SDK architecture
SDK Architecture Pattern - Complete architecture overview
Singleton Hierarchy - Navigate the service tree (4 levels)
Interface Methods - Event listener pattern
Authentication Pattern - Service pattern
🔥 Most Critical Documents
1. SDK Architecture Pattern (⭐ MASTER DOCUMENT)
concepts/sdk-architecture-pattern.md
This is THE most important document. It teaches the universal 3-step pattern:
Get controller (singleton pattern)
Implement event listener (observer pattern)
Register and use
Once you understand this pattern, you can implement any of the 35+ features by just reading the SDK headers.
Key insight: The Zoom SDK follows a perfectly consistent architecture. Every feature works the same way.
2. Windows Message Loop (⚠️ MOST COMMON ISSUE)
troubleshooting/windows-message-loop.md
99% of "callbacks not firing" issues are caused by missing Windows message loop. This document explains:
Why SDK requires
PeekMessage()loopHow to implement it correctly
How to diagnose callback issues
This was the hardest bug to find during development (took ~2 hours).
3. Build Errors Guide
troubleshooting/build-errors.md
SDK headers have dependency bugs that cause build errors. This document provides:
Required include order
Missing
<cstdint>fixMissing
AudioTypefixMissing
YUVRawDataI420fix
📊 By Document Type
Concepts (Why and How)
SDK Architecture Pattern - Universal implementation pattern
Singleton Hierarchy - Navigation guide for SDK services (4 levels deep)
Examples (Complete Working Code)
Authentication Pattern - JWT authentication
Raw Video Capture - Video capture with YUV420, recording vs streaming
Custom UI Video Rendering - SDK-rendered video containers
Breakout Rooms - Create, manage, join breakout rooms
Chat - Send/receive messages with rich formatting
Captions & Transcription - Live transcription and closed captions
Local Recording - Local MP4 recording with permission flow
Share Raw Data Capture - Screen share raw data capture
Send Raw Data - Virtual camera, microphone, and share
Troubleshooting (Problem Solving)
Windows Message Loop - Callback issues
Build Errors - Compilation issues
Common Issues - Quick diagnostics
References (Lookup Information)
Interface Methods - Required virtual methods
Windows Reference - Platform setup
Authorization - JWT generation
Bot Authentication - Bot tokens
Breakout Rooms - Breakout room API
AI Companion - AI features
💡 Key Learnings from Real Debugging
These documents were created from actual debugging of a non-functional Zoom SDK sample. Here are the key insights:
Critical Discoveries:
Windows Message Loop is MANDATORY (not optional)
SDK uses Windows message pump for callbacks
Without it, callbacks are queued but never fire
Manifests as "authentication timeout" even with valid JWT
SDK Headers Have Dependency Bugs
Missing
#include <cstdint>in SDK headersmeeting_participants_ctrl_interface.hdoesn't includemeeting_audio_interface.hrawdata_renderer_interface.honly forward-declaresYUVRawDataI420See: Build Errors Guide
Include Order is CRITICAL
<windows.h>must be FIRST<cstdint>must be SECONDThen SDK headers in specific order
See: Build Errors Guide
ALL Virtual Methods Must Be Implemented
Including WIN32-conditional methods
SDK v6.7.2 requires 6 auth methods + 9 meeting methods
Different versions have different requirements
The Architecture is Beautifully Consistent
Every feature follows the same 3-step pattern
Controllers are singletons
Event listeners use observer pattern
Once you learn the pattern, you can implement any feature
🎓 Learning Path by Skill Level
Beginner (Never used Zoom SDK)
Read SDK Architecture Pattern to understand the overall design
Follow Authentication Pattern to join your first meeting
Reference Common Issues when you hit problems
Intermediate (Familiar with SDK basics)
Deep dive into SDK Architecture Pattern - implement multiple features
Learn Raw Video Capture for media processing
Use Interface Methods as reference
Advanced (Building production bots)
Study SDK Architecture Pattern - learn to implement ANY feature
Master Windows Message Loop - understand async callback flow
Reference SDK headers directly using the universal pattern
🔍 How to Find What You Need
"My code won't compile"
"Authentication times out"
"Callbacks never fire"
"Abstract class error"
"How do I implement [feature]?"
"How do I join a meeting?"
"How do I capture video?"
"What error code means what?"
→ Common Issues - Comprehensive error code tables (SDKERR, AUTHRET, Login, BO, Phone, OBF)
"How do I use breakout rooms?"
"How does the SDK work?"
"How do I navigate to a specific controller/feature?"
"How do I send/receive chat messages?"
"How do I use live transcription?"
→ Captions & Transcription Guide
"How do I record locally?"
"How do I capture screen share?"
📝 Document Version
All documents are based on Zoom Windows Meeting SDK v6.7.2.26830.
Different SDK versions may have:
Different required callback methods
Different error codes
Different API behavior
If using a different version, use grep "= 0" SDK/x64/h/*.h to verify required methods.
Remember: The SDK Architecture Pattern is the fastest way to understand how the Windows Meeting SDK fits together. Read it first if you are debugging custom UI or event flow issues.
Operations
RUNBOOK.md - 5-minute preflight and debugging checklist.
Files
- ATTRIBUTION.mdAdded by AutoGineer999 B
- LICENSELicence file added by AutoGineer1.1 KiB
- RUNBOOK.md2.3 KiB
- SKILL.md44.4 KiB
- concepts/custom-ui-architecture.md8.8 KiB
- concepts/custom-ui-vs-raw-data.md6.1 KiB
- concepts/sdk-architecture-pattern.md20.1 KiB
- concepts/singleton-hierarchy.md20.2 KiB
- examples/ai-companion.md16.5 KiB
- examples/authentication-pattern.md20.7 KiB
- examples/breakout-rooms.md16.9 KiB
- examples/captions-transcription.md18.2 KiB
- examples/chat.md12.8 KiB
- examples/custom-ui-video-rendering.md7.9 KiB
- examples/local-recording.md17.5 KiB
- examples/raw-video-capture.md23.6 KiB
- examples/send-raw-data.md13.2 KiB
- examples/service-quality.md8.1 KiB
- examples/share-raw-data-capture.md16.0 KiB
- examples/video-advanced.md10.3 KiB
- references/deployment.md7.2 KiB
- references/interface-methods.md15.7 KiB
- references/windows-reference.md22.6 KiB
- troubleshooting/build-errors.md10.8 KiB
- troubleshooting/common-issues.md22.1 KiB
- troubleshooting/windows-message-loop.md9.7 KiB
examples/authentication-pattern.md
Authentication Flow Pattern
Complete guide to authenticating with the Zoom Windows SDK using JWT tokens.
Overview
Authentication is the first required step before joining meetings. The SDK uses JWT (JSON Web Token) authentication for Meeting SDK apps.
Flow Sequence
1. Initialize SDK (InitSDK)
2. [OPTIONAL] Register Network Connection Handler for proxy detection
2a. Wait for onProxyDetectComplete() callback
3. Create Auth Service (CreateAuthService)
4. Set Event Listener (SetEvent)
5. Call SDKAuth with JWT token
6. Process Windows messages (CRITICAL!)
7. Wait for onAuthenticationReturn callback
8. Create Meeting Service (CreateMeetingService)
9. Join/Start meeting
10. Wait for MEETING_STATUS_INMEETING callback
11. NOW safe to use controllers (GetMeetingAudioController, etc.)State Machine
┌──────────────┐ InitSDK() ┌──────────────┐
│ UNINITIALIZED │ ─────────────► │ INITIALIZED │
└──────────────┘ └───────┬──────┘
│
│ CreateAuthService() + SDKAuth()
▼
┌──────────────┐ onAuthenticationReturn ┌──────────────┐
│ MEETING │ ◄─────────────────── │ AUTHENTICATING │
│ READY │ (AUTHRET_SUCCESS) └──────────────┘
└───────┬──────┘
│
│ Join() or Start()
▼
┌──────────────┐ onMeetingStatusChanged ┌──────────────┐
│ IN MEETING │ ◄─────────────────── │ JOINING │
│ (Controllers OK)│ (MEETING_STATUS_ └──────────────┘
└──────────────┘ INMEETING)Complete Working Example
#include <windows.h>
#include <cstdint>
#include <zoom_sdk.h>
#include <auth_service_interface.h>
#include <iostream>
#include <chrono>
#include <thread>
using namespace ZOOM_SDK_NAMESPACE;
// Global state
bool g_authenticated = false;
bool g_exit = false;
IAuthService* g_authService = nullptr;
// Step 1: Create Event Listener
class MyAuthListener : public IAuthServiceEvent {
public:
void onAuthenticationReturn(AuthResult ret) override {
std::cout << "[AUTH] Callback received! Result: " << ret << std::endl;
switch (ret) {
case AUTHRET_SUCCESS:
std::cout << "[AUTH] Authentication successful!" << std::endl;
g_authenticated = true;
break;
case AUTHRET_KEYORSECRETEMPTY:
std::cerr << "[AUTH] ERROR: SDK Key or Secret is empty" << std::endl;
break;
case AUTHRET_JWTTOKENWRONG:
std::cerr << "[AUTH] ERROR: JWT token is invalid" << std::endl;
break;
case AUTHRET_OVERTIME:
std::cerr << "[AUTH] ERROR: Authentication timeout" << std::endl;
break;
case AUTHRET_NETWORKISSUE:
std::cerr << "[AUTH] ERROR: Network connection issue" << std::endl;
break;
default:
std::cerr << "[AUTH] ERROR: Unknown error: " << ret << std::endl;
}
}
void onLoginReturnWithReason(LOGINSTATUS ret, IAccountInfo* info, LoginFailReason reason) override {
// Not used for JWT auth
}
void onLogout() override {
std::cout << "[AUTH] Logged out" << std::endl;
}
void onZoomIdentityExpired() override {
std::cout << "[AUTH] Zoom identity expired" << std::endl;
}
void onZoomAuthIdentityExpired() override {
std::cout << "[AUTH] Zoom auth identity expired" << std::endl;
}
#if defined(WIN32)
void onNotificationServiceStatus(SDKNotificationServiceStatus status,
SDKNotificationServiceError error) override {
std::cout << "[AUTH] Notification service status: " << status << std::endl;
}
#endif
};
// Step 2: Initialize SDK
bool InitializeSDK() {
std::cout << "[1/3] Initializing SDK..." << std::endl;
InitParam initParam;
initParam.strWebDomain = L"https://zoom.us";
initParam.strSupportUrl = L"https://zoom.us";
initParam.emLanguageID = LANGUAGE_English;
initParam.enableLogByDefault = true;
initParam.enableGenerateDump = true;
SDKError err = InitSDK(initParam);
if (err != SDKERR_SUCCESS) {
std::cerr << "ERROR: InitSDK failed: " << err << std::endl;
return false;
}
std::cout << "SDK initialized successfully" << std::endl;
return true;
}
// Step 3: Authenticate
bool AuthenticateSDK(const std::wstring& jwt_token) {
std::cout << "[2/3] Authenticating..." << std::endl;
// Create auth service
SDKError err = CreateAuthService(&g_authService);
if (err != SDKERR_SUCCESS || !g_authService) {
std::cerr << "ERROR: CreateAuthService failed: " << err << std::endl;
return false;
}
std::cout << "Auth service created" << std::endl;
// Set event listener
err = g_authService->SetEvent(new MyAuthListener());
if (err != SDKERR_SUCCESS) {
std::cerr << "ERROR: SetEvent failed: " << err << std::endl;
return false;
}
std::cout << "Event listener set" << std::endl;
// Validate JWT token
if (jwt_token.empty()) {
std::cerr << "ERROR: JWT token is empty!" << std::endl;
return false;
}
std::cout << "JWT token length: " << jwt_token.length() << " characters" << std::endl;
// Create auth context
AuthContext authContext;
authContext.jwt_token = jwt_token.c_str();
// Call SDKAuth
err = g_authService->SDKAuth(authContext);
if (err != SDKERR_SUCCESS) {
std::cerr << "ERROR: SDKAuth failed: " << err << std::endl;
return false;
}
std::cout << "SDKAuth called successfully, waiting for callback..." << std::endl;
return true;
}
// Step 4: Wait for Authentication (WITH MESSAGE LOOP!)
bool WaitForAuthentication(int timeoutSeconds = 30) {
std::cout << "[3/3] Waiting for authentication..." << std::endl;
auto startTime = std::chrono::steady_clock::now();
while (!g_authenticated && !g_exit) {
// CRITICAL: Process Windows messages for SDK callbacks!
MSG msg;
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
// Check timeout
auto elapsed = std::chrono::duration_cast<std::chrono::seconds>(
std::chrono::steady_clock::now() - startTime).count();
if (elapsed >= timeoutSeconds) {
std::cerr << "ERROR: Authentication timeout after " << timeoutSeconds << " seconds" << std::endl;
return false;
}
// Small sleep to avoid CPU spinning
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
return g_authenticated;
}
// Main function
int main() {
// Your JWT token here
std::wstring jwt_token = L"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
// Step 1: Initialize SDK
if (!InitializeSDK()) {
return 1;
}
// Step 2: Authenticate
if (!AuthenticateSDK(jwt_token)) {
return 1;
}
// Step 3: Wait for callback
if (!WaitForAuthentication()) {
return 1;
}
std::cout << "\n✓ Authentication complete! Ready to join meeting." << std::endl;
// Now you can join meetings...
// Cleanup
if (g_authService) {
DestroyAuthService(g_authService);
}
CleanUPSDK();
return 0;
}Optional: Network/Proxy Detection
If your app needs to work behind corporate proxies, register the network connection handler after InitSDK but before authentication:
#include <network_connection_handler_interface.h>
class MyNetworkHandler : public INetworkConnectionHandler {
public:
void onProxyDetectComplete() override {
std::cout << "[NETWORK] Proxy detection complete" << std::endl;
// NOW safe to proceed with authentication
g_proxyDetected = true;
}
void onProxySettingNotification(IProxySettingHandler* handler) override {
// Handle proxy settings if needed
std::cout << "[NETWORK] Proxy settings notification" << std::endl;
}
void onSSLCertVerifyNotification(ISSLCertVerificationHandler* handler) override {
// Handle SSL cert verification if needed
std::cout << "[NETWORK] SSL cert verification" << std::endl;
}
};
bool WaitForProxyDetection() {
// Create network helper
INetworkConnectionHelper* networkHelper = nullptr;
CreateNetworkConnectionHelper(&networkHelper);
if (networkHelper) {
networkHelper->RegisterNetworkConnectionHandler(new MyNetworkHandler());
// Wait for onProxyDetectComplete callback
while (!g_proxyDetected) {
MSG msg;
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
return true;
}
return false;
}When to use: Only needed if you're behind a corporate proxy or need SSL certificate handling. Most apps can skip this step.
JWT Token Setup
Generating JWT Token
Go to Zoom Marketplace: https://marketplace.zoom.us/
Create/Select App: Go to "Develop" → "Build App" → "Meeting SDK"
Get Credentials: Find "App Credentials" tab
SDK Key (Client ID)
SDK Secret (Client Secret)
Generate JWT: Use the built-in JWT generator or create manually
JWT Token Format
Valid JWT token:
Length: 200-500 characters
Starts with:
eyJContains: Two periods (
.) separating three partsExample:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBLZXk...
Loading from Configuration File
#include <json/json.h>
#include <fstream>
bool LoadJWTFromConfig(std::wstring& jwt_token) {
std::ifstream f("config.json");
if (!f.is_open()) {
std::cerr << "ERROR: config.json not found" << std::endl;
return false;
}
Json::Value config;
try {
f >> config;
} catch (const std::exception& e) {
std::cerr << "ERROR: Failed to parse config.json: " << e.what() << std::endl;
return false;
}
if (config["sdk_jwt"].empty()) {
std::cerr << "ERROR: sdk_jwt not found in config.json" << std::endl;
return false;
}
std::string jwt_str = config["sdk_jwt"].asString();
jwt_token = std::wstring(jwt_str.begin(), jwt_str.end());
return true;
}config.json:
{
"sdk_jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"meeting_number": "1234567890",
"passcode": "meeting_password"
}Common Authentication Errors
AuthResult Error Codes
| Code | Enum | Meaning | Solution |
|---|---|---|---|
| 0 | AUTHRET_SUCCESS | ✓ Success | Continue to join meeting |
| 1 | AUTHRET_KEYORSECRETEMPTY | SDK Key/Secret empty | Check JWT token |
| 3 | AUTHRET_JWTTOKENWRONG | Invalid JWT | Regenerate token |
| 4 | AUTHRET_OVERTIME | Request timeout | Check network |
| 5 | AUTHRET_NETWORKISSUE | Network problem | Check firewall/internet |
| 7 | AUTHRET_CLIENT_INCOMPATIBLE | SDK version mismatch | Update SDK |
| 10 | AUTHRET_JWTTOKENEXPIRED | JWT expired | Generate fresh token |
Timeout (No Callback)
Symptom: Waiting forever, no callback received
Causes:
Missing Windows message loop (most common!)
Network/firewall blocking
Invalid JWT format
Debug:
void onAuthenticationReturn(AuthResult ret) override {
std::cout << "CALLBACK FIRED! Result: " << ret << std::endl; // Does this print?
}If you never see "CALLBACK FIRED!", you're not processing Windows messages!
Invalid JWT Token
Symptom: AUTHRET_JWTTOKENWRONG (code 3)
Causes:
Token expired (typically 24-48 hours)
Wrong SDK Key/Secret used to generate token
Token generated for different app
Malformed token
Solution:
Generate fresh JWT token from Zoom Marketplace
Verify SDK credentials match
Check token format (starts with "eyJ", has two dots)
Network Issues
Symptom: AUTHRET_NETWORKISSUE (code 5) or timeout
Solutions:
Check internet connection
Verify can access zoom.us from browser
Check Windows Firewall settings
If behind corporate proxy, may need proxy configuration
Temporarily disable antivirus to test
Best Practices
1. Validate JWT Before Using
bool ValidateJWT(const std::wstring& jwt_token) {
// Check length
if (jwt_token.length() < 100) {
std::cerr << "JWT token too short: " << jwt_token.length() << std::endl;
return false;
}
// Check starts with "eyJ"
if (jwt_token.substr(0, 3) != L"eyJ") {
std::cerr << "JWT token doesn't start with 'eyJ'" << std::endl;
return false;
}
// Check has two dots (three parts)
int dotCount = 0;
for (wchar_t c : jwt_token) {
if (c == L'.') dotCount++;
}
if (dotCount != 2) {
std::cerr << "JWT token should have 2 dots, found: " << dotCount << std::endl;
return false;
}
return true;
}2. Add Timeout with Progress Updates
bool WaitForAuthenticationWithProgress(int timeoutSeconds = 30) {
auto startTime = std::chrono::steady_clock::now();
int lastProgressSeconds = 0;
while (!g_authenticated && !g_exit) {
// Process messages
MSG msg;
while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
// Show progress every 5 seconds
auto elapsed = std::chrono::duration_cast<std::chrono::seconds>(
std::chrono::steady_clock::now() - startTime).count();
if (elapsed > lastProgressSeconds && elapsed % 5 == 0) {
std::cout << "Still waiting... (" << elapsed << "s)" << std::endl;
lastProgressSeconds = elapsed;
}
if (elapsed >= timeoutSeconds) {
return false;
}
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
return g_authenticated;
}3. Cleanup on Failure
void Cleanup() {
if (g_authService) {
DestroyAuthService(g_authService);
g_authService = nullptr;
}
CleanUPSDK();
}
int main() {
if (!InitializeSDK()) {
return 1;
}
if (!AuthenticateSDK(jwt_token)) {
Cleanup(); // Always cleanup on failure
return 1;
}
if (!WaitForAuthentication()) {
Cleanup();
return 1;
}
// ... use SDK ...
Cleanup(); // Cleanup on success too
return 0;
}After Authentication: Join/Start Meeting
Once authenticated, create the meeting service and join:
#include <meeting_service_interface.h>
IMeetingService* g_meetingService = nullptr;
bool g_inMeeting = false;
class MyMeetingListener : public IMeetingServiceEvent {
public:
void onMeetingStatusChanged(MeetingStatus status, int iResult) override {
std::cout << "[MEETING] Status changed: " << status << std::endl;
switch (status) {
case MEETING_STATUS_IDLE:
std::cout << "[MEETING] Idle" << std::endl;
break;
case MEETING_STATUS_CONNECTING:
std::cout << "[MEETING] Connecting..." << std::endl;
break;
case MEETING_STATUS_WAITINGFORHOST:
std::cout << "[MEETING] Waiting for host..." << std::endl;
break;
case MEETING_STATUS_INMEETING:
std::cout << "[MEETING] IN MEETING - Controllers now available!" << std::endl;
g_inMeeting = true;
SetupControllers(); // NOW safe to get controllers
break;
case MEETING_STATUS_DISCONNECTING:
std::cout << "[MEETING] Disconnecting..." << std::endl;
break;
case MEETING_STATUS_ENDED:
std::cout << "[MEETING] Ended" << std::endl;
g_inMeeting = false;
break;
case MEETING_STATUS_FAILED:
std::cerr << "[MEETING] FAILED - Error: " << iResult << std::endl;
break;
}
}
void onMeetingStatisticsWarningNotification(StatisticsWarningType type) override {}
void onMeetingParameterNotification(const MeetingParameter* param) override {}
void onSuspendParticipantsActivities() override {}
void onAICompanionActiveChangeNotice(bool active) override {}
void onMeetingTopicChanged(const zchar_t* topic) override {}
void onMeetingFullToWatchLiveStream(const zchar_t* url) override {}
void onUserNetworkStatusChanged(MeetingComponentType type, ConnectionQuality quality,
unsigned int userId, bool uplink) override {}
#if defined(WIN32)
void onAppSignalPanelUpdated(IMeetingAppSignalHandler* handler) override {}
#endif
};
bool CreateAndJoinMeeting(UINT64 meetingNumber, const wchar_t* passcode, const wchar_t* userName) {
// Step 1: Create meeting service
SDKError err = CreateMeetingService(&g_meetingService);
if (err != SDKERR_SUCCESS || !g_meetingService) {
std::cerr << "ERROR: CreateMeetingService failed: " << err << std::endl;
return false;
}
// Step 2: Set event listener
g_meetingService->SetEvent(new MyMeetingListener());
// Step 3: Prepare join parameters
JoinParam joinParam;
joinParam.userType = SDK_UT_WITHOUT_LOGIN;
JoinParam4WithoutLogin& param = joinParam.param.withoutloginuserJoin;
param.meetingNumber = meetingNumber;
param.userName = userName;
param.psw = passcode;
param.isVideoOff = true; // Bot typically joins with video off
param.isAudioOff = false; // But audio on to hear
// Step 4: Join!
err = g_meetingService->Join(joinParam);
if (err != SDKERR_SUCCESS) {
std::cerr << "ERROR: Join failed: " << err << std::endl;
return false;
}
std::cout << "Join() called, waiting for MEETING_STATUS_INMEETING..." << std::endl;
return true;
}
// Call this ONLY after MEETING_STATUS_INMEETING
void SetupControllers() {
// Audio
IMeetingAudioController* audioCtrl = g_meetingService->GetMeetingAudioController();
if (audioCtrl) {
audioCtrl->JoinVoip();
audioCtrl->MuteAudio(0, true); // Mute self
}
// Video
IMeetingVideoController* videoCtrl = g_meetingService->GetMeetingVideoController();
// ...
// Chat
IMeetingChatController* chatCtrl = g_meetingService->GetMeetingChatController();
// ...
}CRITICAL: Controller Availability
| When | Controllers Available? |
|---|---|
Before MEETING_STATUS_INMEETING | NO - Returns nullptr |
After MEETING_STATUS_INMEETING | YES - Safe to use |
After MEETING_STATUS_ENDED | NO - Pointers invalid |
Common mistake: Getting controllers before joining. ALWAYS wait for the MEETING_STATUS_INMEETING callback!
Troubleshooting Steps
Step 1: Check JWT Token
std::cout << "JWT length: " << jwt_token.length() << std::endl;
std::cout << "JWT preview: " << jwt_token.substr(0, 30) << "..." << std::endl;Expected output:
JWT length: 358
JWT preview: eyJhbGciOiJIUzI1NiIsInR5cCI...Step 2: Verify SDKAuth Return
SDKError err = g_authService->SDKAuth(authContext);
std::cout << "SDKAuth returned: " << err << std::endl;0(SDKERR_SUCCESS): Good, wait for callbackNon-zero: Immediate error, check JWT format
Step 3: Confirm Callback Fires
Add logging in onAuthenticationReturn:
void onAuthenticationReturn(AuthResult ret) override {
std::cout << "*** CALLBACK RECEIVED ***" << std::endl; // First line!
// ... rest of code ...
}If you never see "CALLBACK RECEIVED", you need a message loop!
Step 4: Test Network
// Before SDKAuth
std::cout << "Testing network..." << std::endl;
// Try to access zoom.us or check internet connectionSee Also
Windows Message Loop - Why callbacks don't fire
Build Errors - Compilation issues
JWT Token Generation - Creating JWT tokens
Joining Meetings - Next steps after authentication
Requirements and compatibility
Written for: Claude Code, Claude apps
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Claude Code frontmatter, Needs a command-line tool
Security
What our scanner noticed· Low risk
- Instructions that use the network
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Zoom
- Publisher
- Anthropic (Official)
- Distributed by
- Anthropic
- Source
- anthropics/knowledge-work-plugins · partner-built/zoom-plugin/skills/meeting-sdk/windows · commit e050c2e
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from partner-built/zoom-plugin/LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Zoom or Anthropic.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download zoom-meeting-sdk-windows.zip