What API can I use for Imou camera live streaming?

说明与用途

实现了安全、基于角色的 Imou 实时流工作流，抽象 API、租户隔离和清晰的错误处理。

问题

Integrating Imou camera live streaming into a SaaS application while ensuring secure, role‑based access and proper handling of device capabilities.

结果

Implemented a secure, role‑based live streaming workflow that abstracts Imou APIs, enforces tenant isolation, and provides clear error handling without exposing unauthenticated URLs.

工作流

• 1. Verify user has access to the tenant site.
• 2. Call cameraGateway.listDevices(siteId) to retrieve camera inventory.
• 3. Find the requested camera by ID; if not found, show error.
• 4. Call cameraGateway.openLive(camera.externalId) to obtain a play handle.
• 5. Mount the player with the handle (livePlayer.mount(handle)).
• 6. For playback, call cameraGateway.openPlayback after confirming recording capability.
• 7. Handle PTZ, talk, and screenshot via cameraGateway.command only if capabilities allow.
• 8. Map failures to denied, offline, or media and log minimal sensitive data.
• 9. Destroy the player when the tab is hidden or the user stops the stream.
• 10. Ensure all streams are served over HTTPS and reject insecure playlists.

证据

I do not hand the browser a public unauthenticated URL.

来源

I map failures to denied, offline, and media.

来源

I log list, open_live, and play_fail with camera_id and error_class.

来源