Third-party voice debugging
If your product connects to a third-party voice platform outside China, you can use the Cloud Intelligence App or your own app for voice debugging. Supported platforms include Amazon Alexa and Google Assistant.
Prerequisites
Device development must be complete. For more information, see Device-side development.
You must enable and configure a third-party voice service. For more information, see Configure interactive voice response.
Background information
Some products developed on the platform are intended for use outside China, where the main voice platforms are third-party services such as Amazon Alexa and Google Assistant. After you enable a third-party voice service for a device and complete its development, you must debug the device. This ensures the device can correctly call the third-party platform's skills to perform operations such as device sync and control.
Procedure for third-party voice debugging
Log on to the IoT Platform console.
Go to the Device Debugging page for the product.
Click Debug or Online Debugging for the device to open the device debugging page.
Select the Third-party Voice Debugging tab to switch between voice platforms for debugging.
In the Select Debug Device drop-down list, select or enter the DeviceName of the device that you want to debug, and ensure that it is attached to the Cloud Intelligence App or your own app.
NoteThe device that you want to test must be attached to the Cloud Intelligence App or your own app. For more information, see Use the Cloud Intelligence App to control devices with an Amazon Echo speaker.
Select General Instruction or Voice Command to start debugging.
Amazon Alexa voice platform
You can run a simulated test without an Alexa speaker by selecting the following instructions. To run a test, click an instruction on the platform.
General instructions
General instructions are used to debug the API calls that connect the device to the third-party voice platform and report its status.
Click a label to send an instruction. In the Real-time Log pane on the right, verify that the request and response data are correct.
Voice command
Voice commands are functional instructions. You can use them to debug or check if instructions are correctly transformed on the platform. This ensures that functional instructions from Alexa execute correctly.
Click a voice label on the left to send a voice command and debug the device. In the Real-time Log pane on the right, verify that the conversation is correct.
Google Home voice platform
You can run a simulated test without a speaker by selecting the following instructions. To run a test, click an instruction on the platform.
General instructions
General instructions are used to debug the API calls that connect the device to the third-party voice platform and report its status.
Click a label to send an instruction. In the Real-time Log pane on the right, verify that the request and response data are correct.
Voice commands
Voice commands are functional instructions. Use them to debug or check if instructions are correctly transformed on the platform. This ensures that functional instructions from a Google Home speaker execute correctly.
Click a voice label on the left to send a voice command and debug the device. In the Real-time Log pane on the right, verify that the conversation is correct.
(Optional) Debug using a real speaker.
NoteThe following example uses the Amazon Alexa voice platform for third-party voice debugging.
Complete device development and attach the device to an Alexa speaker.
Test by saying "Send instruction" to the speaker instead of clicking "Send Instruction" in the console.
After the instruction is sent successfully, you can view the real-time log on the platform.