App Inventor 2 指令中文化 BluetoothServer 藍牙伺服器

BluetoothServer 藍牙伺服器

Bluetooth server component藍牙伺服器元件。


屬性

Secure
是否使用SSP(簡易安全配對),支援藍牙v2.1或更高版本的設備。當與嵌入式藍牙設備工作時,此屬性可能需要設置為False。(Android2.0-2.2,此屬性設置將被忽略)。

BluetoothServer.Secure : 是否使用SSP


Available
回傳當下的Android裝置上是否可使用藍牙。

BluetoothServer.Available : 取得當下的Android裝置上是否可使用藍牙。


CharacterEncoding
設定收發訊息時的字元編碼。

BluetoothServer.CharacterEncoding取得收發訊息時的字元編碼。
Set BluetoothServer.CharacterEncoding設定收發訊息時的字元編碼。


DelimiterByte
呼叫 ReceiveText、ReceiveSignedBytes、ReceiveUnsignedBytes 等函數時,當引數numberOfBytes 為負值,須使用界定字元(Delimiter Byte)當資料串結尾。 

BluetoothServer.DelimiterByte取得界定字元
Set BluetoothServer.DelimiterByte設定界定字元


Enabled 
本項需設為真,才能使用藍牙。

BluetoothServer.Enabled:取得藍牙用戶端現在是否可使用(boolean)


HighByteFirst
2 及 4 位元組數值是否應先從最高位元開始傳送,確認通訊裝置的文件說明,應能與 app適當通訊,Big-endian俗稱為高位元組資料優先的排序方式。 

BluetoothServer.HighByteFirst取得高位元組資料優先的排序方式。 
Set BluetoothServer.HighByteFirst設定高位元組資料優先的排序方式。 


IsAccepting
代表本BluetoothServer 元件是否允許BluetoothClient的連線要求。

BluetoothServer.IsAccepting:取得是否允許BluetoothClient的連線要求。


IsConnected
是否已建立藍牙連線。

BluetoothServer.IsConnected:取得是否已建立藍牙連線。



事件

ConnectionAccepted
when BluetoothServer.ConnectionAccepted : 當藍牙連線要求已被接受時呼叫本事件。



方法

AcceptConnection(text serviceName)
BluetoothServer.AcceptConnection受SSP的連接請求。


AcceptConnectionWithUUID(text serviceName, text uuid) 
BluetoothServer.AcceptConnectionWithUUID接收由指定UUID 發起的連線要求。


BytesAvailableToReceive()
BluetoothServer.BytesAvailableToReceive回傳在不塞車情況下的可接收位元組數(估計值)。


Disconnect
BluetoothServer.Disconnect中斷藍牙連線。


ReceiveSigned1ByteNumber
BluetoothServer.ReceiveSigned1ByteNumber從所連接的藍牙裝置接收1位元組長度的有號數。


ReceiveSigned2ByteNumber
BluetoothServer.ReceiveSigned2ByteNumber從所連接的藍牙裝置接收2位元組長度的有號數。


ReceiveSigned4ByteNumber
BluetoothServer.ReceiveSigned4ByteNumber從所連接的藍牙裝置接收4位元組長度的有號數。


ReceiveSignedBytes(number numberOfBytes) 
BluetoothServer.ReceiveSignedBytes從所連接的藍牙裝置接收多個有號位元組值。如果numberOfBytes小於 0,將持續讀取直到收到一個界定字元為止。


ReceiveText(number numberOfBytes)
BluetoothServer.ReceiveText從所連接的藍牙裝置接收一個字串。如果numberOfBytes小於 0,將持續讀取直到收到一個界定字元為止。


ReceiveUnsigned1ByteNumber
BluetoothServer.ReceiveUnsigned1ByteNumber從所連接的藍牙裝置接收1位元組長度的無號數。


ReceiveUnsigned2ByteNumber
BluetoothServer.ReceiveUnsigned2ByteNumber從所連接的藍牙裝置接收2 位元組長度的無號數。


ReceiveUnsigned4ByteNumber
BluetoothServer.ReceiveUnsigned4ByteNumber從所連接的藍牙裝置接收4 位元組長度的無號數。


ReceiveUnsignedBytes(number numberOfBytes) 
BluetoothServer.ReceiveUnsignedBytes從所連接的藍牙裝置接收多個無號位元組值。如果numberOfBytes小於 0,將持續讀取直到收到一個界定字元為止。


Send1ByteNumber(text number) 
BluetoothServer.Send1ByteNumber對已連接的藍牙裝置發送1位元組長度的數字。


Send2ByteNumber(text number) 
BluetoothServer.Send2ByteNumber對已連接的藍牙裝置發送2位元組長度的數字。


Send4ByteNumber(text number) 
BluetoothServer.Send4ByteNumber對已連接的藍牙裝置發送4位元組長度的數字。


SendBytes(list list) 
BluetoothServer.SendBytes對已連接的藍牙裝置發送位元組清單,即byte array。


SendText(text text) 
BluetoothServer.SendText對已連接的藍牙裝置發送字串。


StopAccepting
BluetoothServer.StopAccepting不再接收外部連線要求。