積木詳細說明

APP Builder 利用簡單的積木來展現 Zenbo 每個行為的功能。積木可以單獨使用，也可以透過從 Web 圖形介面中拉出來進行序列化組合使用。這些不同的行為函數如下：

脖子
 身體
 臉
 說話
 音檔
 LED
相機
 偵測
 多媒體
 介面
 內建動作
 Loop
變數
 邏輯
 事件
 其他

脖子

Neck Movement

要求機器人以指定的速度水平轉動頭部。

參數
`Blocking`	當前功能完成後運行下一個積木。
`Non-Blocking`	在當前功能啟動後運行下一個積木。
`速度`	1 ~ 3
`垂直`	-15° ~ 55° 正值數字代表Zenbo會向上看。
`水平`	-45° ~ 45° 正值數字代表Zenbo會向左看。

身體

身體運動

以指定的方向和速度級別移動相對距離。

參數
`Blocking`	當前功能完成後運行下一個積木。
`Non-Blocking`	在當前功能啟動後運行下一個積木。
`速度`	1 ~ 7
`方向`	上、下、左、右 Forward: 前進 Backward: 後退；先向後轉並前進，然後在向後轉 Left: 先向左轉然後前進 Right: 先向右轉然後前進
`距離`	以公分為單位的相對距離。

Body Rotation

以指定的速度級別旋轉相對角度。

參數
`Blocking`	當前功能完成後運行下一個積木。
`Non-Blocking`	在當前功能啟動後運行下一個積木。
`速度`	1 ~ 7
`角度`	以度為單位的相對旋轉角度。

臉

臉部表情

設定機器人的表情

參數
表情型態	1. 感興趣	2. 懷疑	3. 驕傲	4. 默認	5. 高興
	6. 期待	7. 驚訝	8. 疑問	9. 不耐煩	10. 自信
	11. 積極	12. 滿足	13. 無助	14. 認真	15. 擔心
	16. 假裝	17. 慵懶	18. 警戒_R	19. 疲累	20. 害羞
	21. 無辜	22. 唱歌	23. 警戒_L	24. 默認_still	25. 隱藏表情

說話

讓機器人說出預定的字串

參數
`說話`	文本到語音的句子。
`速度`	快、中、慢。

說話

讓機器人說出三個字串的其中一串。

參數
`速度`	快、中、慢。
`文檔`	文本到語音的候選句子。

音檔

錄製音檔

讓機器人錄製音檔

參數
`持續時間`	以秒為單位的錄音長度。

播放音檔

讓機器人播放錄製完成的音檔

參數
`音量`	媒體聲音的音量。
`持續時間`	以秒為單位的播放錄音長度。

停止錄製音檔

讓機器人停止錄製音檔

參數

無

停止播放錄音音檔

讓機器人停止播放錄音音檔

參數

無

LED

Non-Blocking輪子LED

控制輪子燈光

參數
`方位`	右側、左側、兩側 Right: 右側的燈光 Left: 左側的燈光 Both: 兩側的燈光
`型態`	Led 型態快速閃爍、閃爍呼吸燈、輪框充電、靜止
`顯示`	點亮的LED燈光數量，每一側有8顆LED。 One: 打開一顆LED。 Quarter: 打開兩顆LED。 Half: 打開四顆LED。 All: 打開全部LED。
`顏色`	LED的顏色。通過顏色選擇器選擇顏色。
`亮度`	0~100, 0表示關燈。
`持續時間`	持續開啟 LED 的時間長度（以秒為單位）。

停止輪子LED

停止輪子燈光。

參數

無

相機

錄影

讓機器人錄製影片

參數
持續時間	持續錄影的時間長度（以秒為單位）

播放錄製的影片

讓機器人播放錄製的影片

參數
音量	影片的音量。
持續時間	影片播放的長度（以秒為單位）。

停止錄影

讓機器人停止錄影

參數

無

停止播放錄製的影片

讓機器人停止播放錄製的影片

參數

無

拍照

讓機器人拍一張照片

參數

無

展示照片

讓機器人展示先前拍攝的照片

參數
持續時間	顯示圖片的時間長度（以秒為單位）。

偵測

當偵測到人臉

當機器人偵測到人臉，開始執行內部的積木。

參數
`所需間隔（秒）`	偵測的時間間隔。

當機器人沒有在充電

當機器人沒有在充電，開始執行內部的積木。

參數

無

當機器人有在充電

當機器人開始在充電，開始執行內部的積木。

參數

無

電池電量

如果電池電量符合此參數，開始執行內部的積木。

參數
`條件`	以上、以下
`數值`	電池剩餘百分比 (0~100)

當聽到

當機器人聽到指定語句，開始執行內部的積木。

參數
`Context`	在對話系統輸入上下文。
`Intent Id`	讓對話指定到特定plan。

多媒體

播放多媒體 Non-Blocking

播放選定的多媒體，在積木輸入數值以調整音量和持續時間。
當機器人播放媒體時，也會同時運行內部積木。

參數
`Source`	要播放的文件，可以是影片或音樂文件。
`Volume`	多媒體的音量。
`Duration`	多媒體的播放長度(以秒為單位)。
`Start Form`	在指定的時間開始播放多媒體(以秒為單位)。

播放多媒體 Blocking

播放選定的多媒體，在積木輸入數值以調整音量和持續時間。

參數
`Source`	要播放的文件，可以是影片或音樂文件。
`Volume`	多媒體的音量。
`Duration`	多媒體的播放長度(以秒為單位)。
`Start Form`	在指定的時間開始播放多媒體(以秒為單位)。

播放帶有圖檔的音樂Blocking

播放選定的多媒體，在積木輸入數值以調整音量和持續時間。

參數
`Music Source`	選擇要播放的音樂
`Image Source`	選擇要顯示的圖檔
`Volume`	多媒體的音量。
`Duration`	多媒體的播放長度(以秒為單位)。
`Start Form`	在指定的時間開始播放多媒體(以秒為單位)。

播放帶有圖檔的音樂 Non-Blocking

播放選定的多媒體，在積木輸入數值以調整音量和持續時間。
當機器人播放時，也會同時運行內部積木。

參數
`Music Source`	選擇要播放的音樂
`Image Source`	選擇要顯示的圖檔
`Volume`	多媒體的音量。
`Duration`	多媒體的播放長度(以秒為單位)。
`Start Form`	在指定的時間開始播放多媒體(以秒為單位)。

停止播放多媒體

停止播放多媒體

參數

無

介面

提示界面

Show a Built-In user interface to hint user how to command robot.顯示內建用戶介面以提示用戶如何命令機器人。

參數
`Tips UI’s ID`	提示介面的ID。
`Countdown UI Title`	提示頁面的標題。
`Countdown UI Duration`	內建用戶介面將顯示的時間長度（以秒為單位）。
`Item`	提示列表 Hint: 副標題 Content: 詳細內容

GridView UI

在螢幕上顯示grid view，在畫面中顯示相應的字串，可透過語音或單擊選擇此項目。

參數
`Text-To-Speech`	當顯示grid view時，讓機器人說話。
`Title`	標題顯示在grid view上方。
`Intent Id`	設定語音命令。 Plans Id: 對話系統中的Plans id。 Value: 設定對話系統意圖(Intent)的信心值。 Context: Dialog系統中Plans id。
`Tips UI’s ID`	定義哪些 Tips 會被執行。
`Event`	Event’s ID: 當項目被選中時呼叫用戶想要的事件。 Media Source: 選擇用戶想要顯示的媒體來源。

ListView UI

"When receive".在螢幕上顯示list view，在畫面中顯示相應的字串，可通過語音或單擊選擇項目。
每個項目的行為將在“何時接收”積木中定義。

參數
`Text-To-Speech`	當顯示list view時，讓機器人說話。
`Title`	標題顯示在list view上方。
`Intent Id`	設定語音命令。 Plans Id: 對話系統中的Plans id。 Value: 設定對話系統意圖(Intent)的信心值。 Context: Dialog系統中Plans id。
`Tips UI’s ID`	定義哪些 Tips 會被執行。
`Event`	Event’s ID: 當項目被選中時呼叫用戶想要的事件。 Media Source: 選擇用戶想要顯示的字串。

內建動作

一次性動作

要求機器人做出指定的動作。

參數
動作類型	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

遞迴運動

要求機器人做出指定的動作。
這是一個不間斷的動作，直到收到“停止動作”的呼叫。也可以使用其他積木，如“邏輯”或“偵測”積木來中斷它。

參數
動作類型	15. Dance_b_1	17. Music_1	21. Dance_s_1
動作類型	24. Dance_2	25. Shake_head_4	26. Head_twist_1

停止動作

Stop running built-in movement.停止正在進行的動作。

參數

無

迴圈Loop

重複_次...做

運行內部積木指定的次數。

參數
`重複`	輸入您想要重複的次數。

While...do

當條件為真時，連續運行內部積木。

參數

可搭配其他積木的條件，如“變數”和“其他”積木。

Break

打破迴圈。

參數

無

變數Variable

Number to Setting

整數的值。

參數

要設定的數量。

Set ... to

設定變數。將字串傳遞給指定變數。

參數
`myVariable`	可以從下拉選單中增加一個新變數。

Set ... to

設定變數。將字串傳遞給指定變數。

參數
`myVariable`	可以從下拉選單中增加一個新變數。

數字變數

回傳此變數的數字。

參數

無

字串變數

回傳此變數的字串。

參數

無

正在充電中

檢查機器人是否正在充電中。

參數
`In Charge`	檢查機器人是否正在充電中。如果正在充電，則該積木為真。
`Not In Charge`	檢查機器人是否正在充電中。如果沒有在充電，則該積木為真。

偵測到人體

確認是否有偵測到人體。

參數

無

電池百分比

取得電池百分比。

參數

無

喇叭音量

取得 Text-To-Speech的音量。

參數

無

Listen

讓機器人聽指定命令。

參數
`Listen`	`==` : 檢查兩個操作數的值是否相等。如果是，則條件變為真。 `!=` : 檢查兩個操作數的值是否相等。如果值不相等，則條件為真。
`Intent Id`	設定語音命令。 Plans Id: 將對話狀況設置魚特定的Plan中。 Context: 在對話系統中某Plans id的文本。