Tuya Device Panel Initialization Guide
Document Version: 20250620
1. Introduction
The device panel initialization guide is displayed before entering the operation panel of each device. It meets the user's needs for guidance and operation when entering the device panel for the first time. It provides more guidance for users before they enter the device panel at a specific moment.
To meet the user experience of different smart devices, you can customize the display information, such as pictures, videos, applets, and applet cards. You can also set different time periods for the trigger mechanism to meet the personalized adjustment needs of different products. This configuration takes effect dynamically.
The configuration steps mainly include release method, trigger timing, and release materials. The following will detail the specific configuration operation process.
2. Prerequisites
- At least one product has been created. Please refer to Create Product for details.
- Only OEM Apps of the Smart Life type with ODM v6.6.0 and above support device panel initialization configuration; otherwise, the configuration will be invalid.
3. Operation Steps
- Log in to the Tuya Developer Platform.
- On the homepage, navigate to Developer Console > Product Development, click to enter product development, and then enter the product's development page.
- In the fourth step of product development, 04 Product Configuration > App Configuration, find "Device Panel Initialization Guide" and click "Settings". Then, continue to configure the trigger timing and release method.
3.1. Trigger Timing Configuration
The trigger timing for device panel initialization configuration refers to the time when the configuration is displayed. Trigger timing includes: "Display once upon first entry" and "Display upon entry within a time period". You must choose one of the trigger timings.
- Display once upon first entry: After the user successfully pairs the device, it will be displayed once before entering the device panel for the first time. It will not be displayed again after that.
- Display upon entry within a time period: The device panel initialization configuration will appear every time the user enters the device panel within this time period.
Trigger Timing Options:
- Display once upon first entry
- Display upon entry within a time period
3.2. Release Method Configuration
Release method supports pictures, videos, applets, and applet cards. Each device can only set one release method.
- Picture: You can upload up to five PNG or GIF images (274px*363px). Each image can be set with a separate hyperlink to jump to the specified Tuya applet.
- Video: You can upload one MP4 video. The video can be set with a hyperlink to jump to the specified Tuya applet.
- Applet: You can release a Tuya custom applet card. Users will be directed to the applet after clicking the applet card.
- Applet Card: You can release a Tuya custom applet. Users will be directed to your applet before entering the panel.
Release Method Options:
- Picture Guide
- Video Guide
- Direct Jump to Applet
- Applet Card Guide
3.3. Release Material Configuration
After configuring the release method and trigger timing, you can configure relevant release materials such as picture/video/applet links according to the selected release method.
3.4. Release Configuration
- Save Configuration: After editing and modifying, click "Save" for the changes to take effect.
- Effect Preview: After the configuration is complete and saved successfully, scan and add the device using the Smart Life OEM App to see the configuration effect.
