How to start
This is a basic tutorial on how to build an app through the DDE Editor.
With this Quick Start guide, you can follow the step-by-step guide to finish your app.
APP flow
Fig. 1. APP flow.
Step 1. Create a new Project
Fig. 2. APP Center.
After logging in, the first place you will arrive at is the App Center, where you can create a new project or edit an existing project.
To create a new project, press the Create a New Project button. And you can edit your domain version; to edit the project, press Edit.
If you want to edit or change the project, you can click the Project Center button to access the project. The project center is the main entrance for all your personal projects.
Fig. 3. Project Center.
Step 2. Fill the app-specific info to Project info
Case 1. For developers to deploy
When you are creating a project for the first time, the app ID is NULL until you register a new app from the App Key Management Note that one project should be assigned a unique App ID, but a project can have more than one domain ID. (You can follow the part2 of A Hello World Sample Project for DDE)
Having successfully registered the app, you will get an ID generated from the App Key Management. Now from the App ID field, you can choose the ID you just got. Note that you can use the same ID for other projects as well.
For case 1, all you need to fill in by yourself are the Domain Name and App ID, and then the other fields will be filled automatically after you have chosen an app ID.
Fig. 4. Project Info-> register a domain ID.
Fig. 5. Register a new Domain Name.
Fig. 6. For case 1, you only need to fill in the Domain Name and App ID..
If you want to see the UUID, a universally unique identifier, for a domain, click DDE Domain ID -> All, and the User Domain List will pop up showing you the information regarding that domain ID. (see Fig. 7. and 8.)
Fig. 7. Click All to access the list describing all the domains..
Fig. 8. A list showing you the information, such as UUID, of the domain of ID=11382.
The Register Background Context Field
Only apps whose register background context field is true continue listening to contexts even after being switched to the background.
Case 2. For developers to test
Case 2 is for users who only intend to use the DDE editor to test an app flow but don’t want it to be deployed at all. In contrast to Case 1, you can leave the app ID field blank by not selecting any. However, you have to to fill in “DDE Domain ID”, “Package Name”, “Launch Activity” and “App Names” by yourself. The system will not do it for you. (see Fig. 9.)
For example,
“Package Name”: "com.asus.webTest"
“Launch Activity”: "test.webTestActivity"
“App Names”: "webTest"
Fig. 9. For case 2, you need to fill in the Domain Name, Package Name, Launch Activity and App Name.
Step 3. Create a Concept
Once you’ve created your project, you probably need to create some concepts for your application.
You can define a category of instances in “concepts” by selecting the Concepts tag and press Add to create a new concept. After clicking Add , it will generate a new concept called New Node. You can click it and change the properties of this concept.
Fig. 10. Create a concept.
Fig. 11. Create some instances of the animal concept.
Step 4. Create an Intent
To support the interaction between people and robots, you will need different types of sentences to catch what the user might say to the robot. Creating intents can help users achieve this goal easily.
Fig. 12. Create intents.
Fig. 13. Create some sentences of the intent play_animal.
Fig. 14. Sentences containing references of concepts..
Step 5. Create Plans
A plan means the actions that your application performs after it hears the request from a person.
If you have completed the above steps, you should have already built the concepts and intents. Now, you need to build plans to create flows of the app. Click the Plans tag, and click Add to create a plan. Then click NewNode1 to edit it.
Fig. 15. Create a plan.
Fig. 16. Content of the plan play_animal_plan.
Fig. 17. The condition of an action.
Fig. 18. You can create more than one action.
Step 6. Publishing App
After you have finished creating an app, you can click Publish to upload it.
When the uploading is complete, you will see the message "Success".
Fig. 19. Publish the app.
When you have finished updating, you will see the message "Success".
Fig. 20. Published successfully.
Step 7. Testing
You can test the app simply by using the test window on the right panel.
Fig. 21.Testing window.
Input a query sentence by using a microphone or typing. You can select all apps or specified apps to limit what you want to test (You can only select apps which belong to your account under "Specified apps".). For example, type ‘animal solitaire game’, and you can see the results displayed below.
Fig. 22. Test results of the tested sentence.
In addition, it will show the output results in the json format like this:
Fig. 23. Testing results in the json format.