App Inventor 2 指令中文化 NxtColorSensor 顏色感應器

NxtColorSensor 顏色感應器
 
功能

NxtColorSensor 元件可用來控制樂高NXT 機器人上的觸碰感應器。


屬性

BluetoothClient
用於通訊的BluetoothClient 元件,必須在Designer 中設定。

SensorPort
感應器所連接的輸入端,必須在Designer 中設定。

DetectColor
設定顏色感應器要偵測顏色或是光值。設定為true 代表應偵測顏色變化,反之則如同光感應器一樣偵測光值變化。

如果DetectColor 屬性設定為 True,那麼BelowRangeWithinRange、AboveRange 等事件都不會被呼叫,感應器前端也不會發光。

如果DetectColor 屬性設定為 False,則ColorChanged 事件不會被呼叫。

NxtColorSensor.DetectColor取得顏色感應器要偵測顏色或是光值
Set NxtColorSensor.DetectColor設定顏色感應器要偵測顏色或是光值


ColorChangedEventEnabled
當DetectColor 屬性設定為true 且偵測到的顏色發生變化時,設定是否呼叫ColorChanged事件。

NxtColorSensor.ColorChangedEventEnabled取得是否呼叫ColorChanged事件。
Set NxtColorSensor.ColorChangedEventEnabled定是否呼叫ColorChanged事件。


GenerateColor
設定顏色感應器是否會發光,只接受紅綠藍等三種顏色,這也是顏色感應器所能產生的
三種顏色。當DetectColor 屬性設定為true 時,顏色感應器不會發光。

NxtColorSensor.GenerateColor取得顏色感應器是否會發光
Set NxtColorSensor.GenerateColor設定顏色感應器是否會發光


BottomOfRange
BelowRange、WithinRange 和AboveRange 等事件的最小值。

NxtColorSensor.BottomOfRange取得BelowRange、WithinRange 和AboveRange 等事件的最小值。

Set NxtColorSensor.BottomOfRange設定BelowRange、WithinRange 和AboveRange 等事件的最小值。


TopOfRange
BelowRange、WithinRange 和AboveRange 等事件的最大值。

NxtColorSensor.TopOfRange取得BelowRange、WithinRange 和AboveRange 等事件的最大值。

Set NxtColorSensor.TopOfRange設定BelowRange、WithinRange 和AboveRange 等事件的最大值。


BelowRangeEventEnabled
決定當DetectColor 屬性設定為false 且光值低於BottomOfRange 時,是否呼叫Below-
Range 事件。

NxtColorSensor.BelowRangeEventEnabled取得光值低於BottomOfRange 時,是否呼叫BelowRange 事件。

Set NxtColorSensor.BelowRangeEventEnabled設定光值低於BottomOfRange 時,是否呼叫BelowRange 事件。


WithinRangeEventEnabled
決定當DetectColor 屬性設定為false 且光值介於BottomOfRange 與TopOfRange 時,是否呼叫WithinRange 事件。

NxtColorSensor.WithinRangeEventEnabled取得光值介於BottomOfRange 與TopOfRange 之間時,是否呼叫WithinRange 事件。

Set NxtColorSensor.WithinRangeEventEnabled設定光值介於BottomOfRange 與TopOfRange 之間時,是否呼叫WithinRange 事件。


AboveRangeEventEnabled
決定當DetectColor 屬性設定為false 且光值高於TopOfRange 時,是否呼叫

NxtColorSensor.AboveRangeEventEnabled取得光值超過TopOfRange 時,是否呼叫AboveRange 事件。

Set NxtColorSensor.AboveRangeEventEnabled設定光值超過TopOfRange 時,是否呼叫AboveRange 事件。



事件

ColorChanged(number color)
偵測到的顏色已改變。

when NxtColorSensor.ColorChanged : 如果DetectColor 或ColorChangedEventEnabled 屬性任一項設定為 False,ColorChanged 事件不會發生。


BelowRange
when NxtColorSensor.BelowRange : 光值已經低於指定範圍。

如果DetectColor 屬性設定為 True 或BelowRangeEventEnabled 屬性設定為 False,Below-Range 事件不會發生。


WithinRange
when NxtColorSensor.WithinRange : 光值介於指定範圍之間。

如果DetectColor 屬性設定為 True 或BelowRangeEventEnabled 屬性設定為 False,Below-Range 事件不會發生。


AboveRange
when NxtColorSensor.AboveRange : 光值已經高於指定範圍。

如果DetectColor 屬性設定為 True 或AboveRangeEventEnabled 屬性設定為 False,AboveRange 事件不會發生



方法

GetColor
NxtColorSensor.GetColor : 回傳所偵測到的顏色,如果回傳值為none 代表無法辨識顏色或因為DetectColor 屬性設定為false 所導致。


GetLightLevel
NxtColorSensor.GetLightLevel : 回傳光值強度,這是一個介於0 到1023 之間的整數,如果回傳-1 代表無法讀取光值或因為DetectColor 屬性設定為true 所導致。