前面介紹完了Blackey Script主要的功能,
在這裡虎喵小編想介紹剩餘的API,有時候缺少這些函數會很麻煩呀 (っ´ω`c)

Functions

函數 功能 範例
print (expression1, …) 列印參數到日誌視窗 print(x);
random ( value ) 回傳 0 ~ (value-1) 之間的隨機數 x = random(10);
msleep ( value ) 睡眠 value 毫秒 msleep(500);

print (expressions)

首先來介紹一下debug的好捧由,print函數吧~
你可以使用print函數列印數個不同的表達式,
print函數會印出每個表達式計算得到的原型。
關於Blackey Script的基本型態,可以參考這篇文章
這邊我們簡單做個示範:

x = 1;
y = pos(0.1, 0.2);
z = “Hello Blackey!”;
print(“x = “, x);
print(y, y);
print(z);

輸出結果:

x = , 1.000000
[(0.100000, 0.200000)] , [(0.100000, 0.200000)]
Hello Blackey!

random (value)

再來是隨機函數random,
如果你想要隨機的決定腳本行為時就可以派上用場囉。
調用的方法也很簡單,只要填入你預期的範圍即可,
回傳的值會是從 0 到 (輸入值-1) 之間的一個隨機數。
例如我想要獲取 1~10 的隨機數的話,可以這樣子寫:

randomValue = 1 + random(10);

random(10) 會回傳 0~9 的隨機數,所以只要加上1就可以把範圍變成 1~10 囉
如果你不放心的話,可以馬上寫個腳本來驗證看看:

x = 0;
while (x < 10) {

print(x, random(10));
x = x+1;

}

輸出結果,可以看到最小值的 0 跟最大值的 9 剛好都印出來了

0.000000 , 0.000000
1.000000 , 4.000000
2.000000 , 6.000000
3.000000 , 2.000000
4.000000 , 6.000000
5.000000 , 7.000000
6.000000 , 5.000000
7.000000 , 6.000000
8.000000 , 9.000000
9.000000 , 8.000000

msleep (value)

最後就是msleep函數啦,顧名思義它就是用來睡覺用的。
使用的時機是當你想要延後一點執行下一個表達式時使用,
其實我們已經在前面的腳本使用過幾次囉。
在腳本錄製模式下,也會自動判斷你動作之間的間隔來填入msleep。
使用的方式很簡單,填入多少值就會睡多久 Z..z.(´-ω-`)

// 隨機睡 0.5 ~ 1.5 秒
sleepTime = 500 + random(1000);
msleep(sleepTime);

需要提醒的是,msleep的單位是毫秒(1/1000 sec),
不過,如果你真的很想要用sleep函數的話…
下一篇文章我們會來教教大家怎麼使用自定義函數來擴展自己的函式唷!