Contact Us
Log In


Last Updated on : 2021-08-17 06:33:54download

Tuya IoT Platform provides real-time video access of HLS protocol for IoT devices that are capable of transmitting audio and video.

Get real-time video links of HLS protocol

Function description

The user can get real-time video links to the HLS protocol.

API address

POST /v1.0/users/{uid}/devices/{device_id}/stream/actions/allocate

Request parameter

Parameter Type Location Description Required
type String BODY Real-time video protocol. The fixed value of the HLS protocol is hls. Yes

Response parameter

Parameter Type Description
result Url Decryption key to the cloud storage video
success Boolean Status of the response result
t Long The 10-bit timestamp of the response result, accurate to a millisecond.
  • Url
Parameter Type Description
url String Real-time video address

Request example

    "type": "hls"

Response example

    "result": {
        "url": "https://wework1.wgine.com:554/hls/6cf2b6d2b09a2f8597gudm/bu4fsmh525q955j6djugBCKwOc8MJioR8BzQ63Yb.m3u8?signInfo=J%2FnrpQ1xQk5rcJc7TsGc7h7AAklEodbn0yDxm90dT0PtAl5lyB7uwq7%2Br3J0%2FeV0PixGQXys%2FLkCKr6svF3whoMVb40FEcv254VrLRdco8XeZThMAkpyL%2Fkx5Nzl8%2Fz4Jenciq%2FKiQDnap3yVvWwyub73NEzMpx4JA6a5rRZhg****"
    "success": true,
    "t": 1602813530973



Module component

  • Web front-end

    • Provide the page for Chrome to visit URL and get HLS play address.
  • Web back-end

    • Hosted web page.
    • Visit the Tuya IoT Platform and get different configuration information through HTTP protocol.
    • Visit the Tuya IoT Platform and request HLS play address through HTTP protocol.
  • Tuya IoT Platform

    • Provide HTTP APIs for different open platforms.


  • You have created a cloud development project on the Cloud Development Platform.
  • You have already got the webrtc.json file.
  • You have already installed VLC. The download address is as follows.


  1. Log in to the Cloud Development Platform and get Access ID and Access Secret in the project information.

  2. Update Access ID and Access Secret to clientId and secret in the webrtc.json file respectively.

  3. Update authorization mode and information.

    • Simple mode:
      • authMode: enter easy
      • uId:
    • Authorization code mode:
      • authMode: enter auth
      • code: authorization code. After the authorization is approved on the Tuya Open Platform, get the authorization code in the browser callback URL.
  4. Enter deviceId. Select an IPC in the Tuya Smart app and check the device ID.

  5. Download the source code from GitHub. In the root directory of the source code, execute go get and then execute go build.

  6. Execute ./webrtc-demo-go.

  7. Open http://localhost:3333/api/stream/hls with Chrome and get the HLS play address.

  8. Enable the network in VLC in 30 seconds, and enter the HLS play address to play HLS live stream.