wehub-resource-sync
2.5 KiB
Known Limitations & Quirks
Common gotchas and limitations developers encounter.
Recording Limitations
Minimum Recording Duration
Recordings shorter than 3-5 seconds will NOT be saved.
This applies to:
- Cloud recordings
- Local recordings via SDK
If you need to capture very short sessions, ensure the recording runs for at least 5 seconds.
API Limitations
Rate Limits
See Rate Limits for detailed information.
Key points:
- Create/update meeting endpoints are Heavy (stricter limits)
- Response headers show remaining quota
- Implement exponential backoff for 429 errors
Error Code 0
The enum value 0 often represents SUCCESS, not failure.
Always check the SDK enum values:
// Example: Meeting SDK
SDKERR_SUCCESS = 0 // This is success!
SDKERR_UNKNOWN = 1 // This is an error
Don't assume 0 = error in your error handling.
Video SDK Web Limitations
Video Rendering Performance
Use ONE rendering control for all videos, not one per participant.
Multiple rendering controls severely degrade performance. See Video SDK Web.
SharedArrayBuffer
Some features require SharedArrayBuffer headers:
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
As of v1.11.2, this is elective for basic functionality.
SDK Signature Limitations
Minimum Token Validity
Zoom may require exp - iat >= 2 hours.
Workaround: Set iat in the past:
const iat = Math.floor(Date.now() / 1000) - 7200; // 2 hours ago
const exp = Math.floor(Date.now() / 1000) + 10; // 10 seconds from now
This gives you a short-lived token while satisfying the validity requirement.
SDK Download
Marketplace Sign-in Required
Meeting SDK and Video SDK (except Web npm packages) must be downloaded from Marketplace after signing in.
They are not available on public package managers for native platforms.
Platform-Specific
iOS
- Requires camera/microphone entitlements
- Background audio requires special configuration
Android
- Requires runtime permissions for camera/mic
- ProGuard rules may be needed
Linux
- Headless operation requires X virtual framebuffer (Xvfb) for some features
- Limited UI customization compared to other platforms
Resources
- Developer forum: https://devforum.zoom.us/ (search for known issues)
- Support: https://devsupport.zoom.us/