Choose an integration mode
Choose an integration mode
Pick one or more approaches that match your product. The table below reflects the current integration guidance.
| Mobile app | Cloud live | Desktop app | OAuth 2.0 | |
|---|---|---|---|---|
| Protocol | Private protocol | HLS, RTMP | Private protocol | HTTPS, OAuth H5 |
| Time to first frame | 1–2 seconds | 3–8 seconds | 1–2 seconds | Depends on API |
| Stream latency | 1–2 seconds | 8–10 seconds | 1–2 seconds | RTSP (see getStreamUrl) |
| Live preview | Supported | Supported | Supported | Supported (authorized devices) |
| Recorded playback | Supported | Not supported | Supported | Per API capability |
| Two-way talk | Supported | Not supported | Supported | Per API capability |
| Device configuration | Supported | Not supported | Supported | Per API capability |
| Integration effort | High | Very low | High | Medium (server + H5) |
| Typical timeline | 1–3 months | 1–8 hours | 1–3 months | Days to weeks |
Mobile app
Integrate OpenSDK in an Android or iOS app for provisioning, device control, live preview, recorded playback, and two-way talk. See Build a mobile app.
Cloud live
Create a live URL for a bound device and embed it in a web page, WeChat official account, or H5: HLS for quick embed; RTMP via createDeviceRtmpLive—see From AppId to cloud live. Streams typically use H.264 video and AAC audio. If your player cannot decode the stream, change the encoding on the device’s local management page (on the LAN where the device sits). See Cloud live concept and HLS cloud live.
Desktop app
Use the PC OpenSDK to build a desktop app with device control, live preview, recorded playback, and two-way talk. See Build a desktop app.
OAuth 2.0
Connect end users' own Imou Life devices after they confirm on the platform authorization page. Your server holds the OAuth project Secret Key, exchanges the authorization code for tokens, and calls Open APIs with the user's Ot_ token. See OAuth 2.0 authorization and OAuth authorization APIs. This is not the same as binding devices to your developer account or using sub-accounts.
To embed a player in a web page, use the light-application component. See Integrate the light application. Download packages from Downloads.