Zenbo APP Builder – Blocks (API) Description
Head
Base
Face
Speech
Sound
LED
Camera
Sensing
Multi-media
Interface
SpecificAction
Loop
Variable
Logic
Others
Move Head
Ask robot to turn its head with specified speed level.
| Parameters | |
Vertical |
-15° ~ 55° Positive value means that the robot will look up. |
Horizontal |
-45° ~ 45° Positive value means that the robot will turn to the left. |
Speed |
1 ~ 3 Blocking: Run next block after current function has finished. Non-Blocking: Run next block after current function has started. |
Move Base
Move a relative distance with specified direction and speed level.
| Parameters | |
Direction |
Up, down, left, right. Up: Go forward Down: Go backward; turn back and go straight and then turn back again. Left: Turn left and go straight Right: Turn left and go straight |
Distance |
Relative distance in centimeters. |
Speed |
1 ~ 7 Blocking: Run next block after current function has finished. Non-Blocking: Run next block after current function has started. |
Rotate Base
Rotate a relative angle with specified speed level.
| Parameters | |
Angle |
Relative rotational angle in degrees. |
Speed |
1 ~ 7 Blocking: Run next block after current function has finished. Non-Blocking: Run next block after current function has started. |
Expression
Set the robot expression.
| Parameters | |||||
Face type |
1. interested | 2. doubting | 3. proud | 4. default | 5. happy |
| 6. expecting | 7. shocked | 8 .questioning | 9. impatient | 10. confident | |
| 11. active | 12. pleased | 13. helpless | 14. serious | 15. worried | |
| 16. pretending | 17. lazy | 18. aware_R | 19. tiredZenbo | 20. shy | |
| 21. innocent | 22. singing | 23. aware_L | 24. default_still | ||
Random Say
Ask robot to speak one string among three strings.
| Parameters | |
String |
Candidate sentences of text to speech. |
Speed |
Slow, medium, fast. |
Zenbo Say
Ask robot to speak given string.
| Parameters | |
String |
Sentence of text to speech. |
Speed |
Slow, medium, fast. |
Record Sound
Ask robot to record sound.
| Parameters | |
Duration |
The length of the recoding in seconds. |
Play Record Sound
Ask robot to play the sound that was just recorded.
| Parameters | |
Volume |
Volume of media sound. |
Duration |
The length of time that the recording would be played in seconds. |
Stop Play Sound
Ask robot to stop playing the recorded sound.
| Parameters |
| None |
Stop Record Sound
Ask robot to stop recording sound.
| Parameters |
| None |
Wheel LED
Control wheel lights.
| Parameters | |
Side |
Right, left, both. Right: Lights on right side. Left: Lights on left side. Both: Lights on both sides. |
Type |
Led pattern. Blink, Twinkle. Breathing, Marquee, Charging, Static. |
Color |
The color for LED lights. Select color by the color picker. |
Led Number |
Number for turning on led. 8 LEDs on each side. One: Turn on one LED. Quarter: Turn on 2 LEDs. Half: Turn on 4 LEDs. All: Turn on all LEDs. |
Brightness |
0~100, 0 means turning off the light. |
Duration |
The length of time that the LED would be turned on in seconds. |
Stop LED
Stop wheel lights.
| Parameters |
| None |
Take a picture
Ask robot to take a picture.
| Parameters |
| None |
Play Recent Capture Photo
Ask robot to display the picture that was just captured.
| Parameters | |
Duration |
The length of time that the picture would be displayed in seconds. |
Record Video
Ask robot to record video.
| Parameters | |
Duration |
The length of the recoding in seconds. |
Stop Record Video
Ask robot to stop recording video.
| Parameters |
| None |
Play Record Video
Ask robot to play the video that was just recorded.
| Parameters | |
Volume |
Volume of media sound. |
Duration |
The length of time that the video would be played in seconds. |
Stop Play Record Video
Ask robot to stop playing the recorded video.
| Parameters |
| None |
If Battery
If the battery encounters the condition, run inner blocks.
| Parameters | |
Condition |
Above, below. |
Value |
Percentage of battery remaining (0~100). |
If Hardware in charge
If the robot detects that the hardware is in charge, run inner blocks.
| Parameters |
| None |
If Hardware not in charge
If the robot detects that the hardware is not in charge, run inner blocks.
| Parameters |
| None |
If Detected Face
If the robot detects a person's face, run inner blocks.
| Parameters |
| None |
Play Media non-blocking
Play selected media source, adjust volume and duration with given value.
When robot plays the media, it will also run the inner blocks at the same time.
| Parameters | |
Source |
The file that you want to play, it can be video or music file. |
Volume |
Volume of media sound. |
Duration |
The length of time that the source would be played in seconds. |
Play Media blocking
Play selected media source, adjust volume and duration with given value.
| Parameters | |
Source |
The file that you want to play, it can be a video or music file. |
Volume |
Volume of media sound. |
Duration |
The length of time that the source would be played in seconds. |
Stop Play Multi-media
Stop playing the media source.
| Parameters |
| None |
ListView
Display a list view on screen, show correspond string in view, selected item by voice or click.
Each item’s behavior would be defined in the Event Receive Block.
| Parameters | |
TTS |
Ask robot to speak when list view is shown. |
Title |
Title shown above list view. |
Event name |
Call the event which user wants when the item is selected. |
Event string |
Text to show on item. |
Intent Id |
Voice commands settings. Id: Let dialog state set to specific plan. Value: Instances set in Concepts of Dialog System. Context: Input Context of Dialog System. |
GridView
Display a grid view on screen, show correspond string in view , selected item by voice or click.
| Parameters | |
TTS |
Ask robot to speak when grid view is shown. |
Title |
Title shown above grid view. |
| Item | Select the media source which you want to show. |
Event name |
Call the event which the user wants when the item is selected. |
Event string |
Text to show on item. |
Intent Id |
Voice commands settings. Id: Let dialog state set to specific plan. Value: Instances set in Concepts of Dialog System. Context: Input Context of Dialog System. |
Specific Action(loop)
Ask robot to do specific action.
It is a non-stop action till call “StopSpecificAction” is received. You also can use other blocks like “logic” or “sensing” blocks to interrupt it.
| Parameters | |||
Action type |
15. Dance_b_1 | 17. Music_1 | 21. Dance_s_1 |
| 24. Dance_2 | 25. Shake_head_4 | 26. Head_twist_1 | |
Specific Action
Ask robot to do specific action.
| Parameters | |||||
Action type |
0. Default_1 | 1. Default_2 | 2. Nod_1 | 3. Head_up_1 | 4. Head_up_2 |
| 5. Shake_head_1 | 6. Head_up_3 | 7. Head_up_4 | 8. Head_down_1 | 9. Head_down_2 | |
| 10. Head_down_3 | 11. Shake_head_2 | 12. Head_down_4 | 13. Head_up_5 | 14. Head_down_5 | |
| 16. Head_up_5 | 18. Turn_left_1 | 19. Turn_left_2 | 20. Shake_head_3 | 22. Body_twist_1 | |
| 23. Body_twist_2 | 27. Dance_3 | 28. Shake_head_5 | 42. Head_down_6 | 43. Head_down_7 | |
| 44. Turn_right_1 | 45. Turn_right_2 | 46. Turn_left_reverse_1 | 47. Turn_right_reverse_1 | 48. Turn_left_reverse_2 | |
| 49. Turn_right_reverse_2 | 54. Head_up_6 | ||||
Stop Specific Action
Stop running specific action.
| Parameters |
| None |
Repeat
How many times you want to play the inner blocks.
| Parameters | |
Repeat |
Number of times you want to repeat. |
Set ... to
Variable setting. Pass a value to a specific variable.
| Parameters | |
Item |
Name of variable. You can also add one new variable from the drop down menu. |
Zenbo Battery Level
Get battery percentage.
| Parameters |
| None |
Zenbo Listen String
Ask robot to listen to command.
| Parameters | |
Intent Id |
Voice commands settings. Id: Let dialog state set to specific plan.Context: Input Context of Dialog System. |
Zenbo Speak Volume
Get TTS volume.
| Parameters |
| None |
If ... do
If the condition is true, run the inner blocks.
| Parameters |
| Condition setting with other blocks, like “Variable” and “Others” blocks. |
Condition setting blocks
If the first variable is equal to the second variable, run the inner blocks.
| Parameters |
| Condition setting with other blocks, like “Variable” and “Others” blocks. |
Start
Project’s entry point. This shows which block stack would be executed.
| Parameters |
| None |
String
Value of string type.
| Parameters | |
String |
Text to setting |
Number to setting
Value of integer type.
| Parameters |
| Number to setting |
repeat ... do
While the condition is true, run the inner blocks repeatedly.
| Parameters |
| Condition setting with other blocks, like “Variable” and “Others” blocks. |