Serial
Liste der Typen:
Die Serial Library erlaubt Verbindungen mit anderen Bluetooth Geräten unter
Benutzung von RFCOMM, auch virtuelle
Serielle Schnittstelle (virtual serial port) genannt.
Diese Library braucht Android 2.0 (API level 5) oder höher.
Das Serial Objekt muß als Prozess globales Objekt deklariert werden.
Nach der Initialisierung des Objektes kann man Connect aufrufen um es mit
anderen Geräten, mit der MAC
Adresse (Media-Access-Control-Adresse) des Zielgerätes, zu verbinden.
Zuerst muß man eine gepaarte Gerätemap (Map = Collection Objekt) bekommen.
Diese Map enthält Schlüsselname und Adresse für jedes Gerätepaar.
Um Verbindung mit anderen Geräten zu erlauben können Sie Listen aufrufen. Wenn
eine Verbindung aufgebaut ist wird ein Connected Event ausgelöst.
Es gibt keine Probleme auf Verbindungen zu hören und versuchen neue
Verbindungen mit einem anderen Gerät zu erstellen (das erlaubt Ihnen die
gleiche Anwendung auf zwei Geräten zu benutzen ohne einen Server und einen
Kunden zu definieren müssen.
Ein Serial Objekt kann nur eine einzige Verbindung behandeln. Wenn eine neue
Verbindung aufgebaut ist, wird sie die vorhergehende ersetzen.
Siehe dieses Tutorial
(deutsch) oder dieses tutorial
(englisch) für mehr Informationen.
Permissions / Erlaubnisse:
android.permission.BLUETOOTH
Events:
Connected (Success As Boolean)
Members:
Address As String [read only]
Connect (MacAddress As String)
Connect2 (MacAddress As String, UUID As String)
Connect3 (MacAddress As String, Port As Int)
Disconnect
GetPairedDevices
As Map
Initialize
(EventName As String)
InputStream As java.io.InputStream [read only]
IsEnabled As Boolean
Listen
Listen2 (Name As String, UUID As String)
Name As String [read only]
OutputStream As java.io.OutputStream [read only]
StopListening
Members Erklärung:
Gibt die aktuelle MAC Adresse
(Media-Access-Control-Adresse) des Gerätes zurück.
Connect (MacAddress As String)
Versucht eine Verbindung mit
einem Gerät mit der gegebenenMAC Adresse (Media-Access-Control-Adresse)
aufzubauen. Der Verbindungsaufbau wird im Hintergrund vorgenommen.
Ein Connected Event wird ausgelöst wenn die Verbindung aufgebaut ist (oder auch
falls sie fehlgegangen ist).
Der UUID (Universally Unique Identifier) der für die
Verbindungen benutzt wird ist der Standard UUID:
00001101-0000-1000-8000-00805F9B34FB.
Connect2 (MacAddress As String, UUID As String)
Versucht eine
Verbindung mit einem Gerät mit der gegebenen Adresse und dem gegebenen UUID (Universally Unique
Identifier) aufzubauen. Der Verbindungsaufbau wird im Hintergrund vorgenommen.
Ein Connected Event
wird ausgelöst wenn die Verbindung aufgebaut ist (oder auch falls sie
fehlgegangen ist).
Connect3 (MacAddress As String, Port As Int)
Dies ist eine
Alternativmethode für Geräte die nicht mit Connect oder Connect2 funktionieren.
Siehe diesen Thread issue für mehr Information.
Disconnect
Löst die Verbindung auf
(falls sie existiert) und stoppt das Abhören auf neue Verbindungen.
GetPairedDevices As Map
Gibt eine Map
(Collection Objekt) zurück mit den gepaarten Geräten als Wertepaare, Name als
Schlüsselwort und Adresse als Wert.
Der folgende Code zeigt die zur Verfügung stehenden Geräte an und erlaubt dem Benutzer
mit einem dieser Geräte in Verbinden zu gelangen:
Dim PairedDevices As Map
PairedDevices = Serial1.GetPairedDevices
Dim l As List
l.Initialize
For i = 0 To PairedDevices.Size - 1
l.Add(PairedDevices.GetKeyAt(i))
Next
Dim res As Int
res = InputList(l, "Choose device", -1) 'show list
with paired devices
If res <> DialogResponse.CANCEL Then
Serial1.Connect(PairedDevices.Get(l.Get(res))) 'convert
the name to mac address and connect
End If
Initialize (EventName As String)
Initialisiert das Objekt. Sie
sollten IsEnabled aufrufen bevor Sie anfangen mit dem Objekt zu arbeiten.
InputStream As java.io.InputStream
[read only]
Gibt den InputStream zurück
der benutzt wird um die Daten von dem anderen Gerät zu lesen.
Muß aufgerufen werden nachdem die Verbindung erstellt ist.
IsEnabled As Boolean
Testet ob Bluetooth aktiviert
ist.
Listen
Startet das Abhören auf
eingehende Verbindungen mit dem Standard-UUID.
Ein Connected Event wird ausgelöst wenn die Verbindung aufgebaut ist.
Nichts wird passieren wenn das Gerät schon auf Verbindungen hört.
Listen2 (Name As String, UUID As String)
Startet das Abhören auf
eingehende Verbindungen.
Ein Connected Event wird ausgelöst wenn die Verbindung aufgebaut ist.
Nichts wird passieren wenn das Gerät schon auf Verbindungen hört.
Name – Ein willkürlicher String der für interne Registrierung benutzt wird.
UUID – Der UUID (Universally Unique Identifier) der für diese Aufnahme
definiert ist.
Name As String [read only]
Gibt den Schlüsselnamen des
aktuellen Gerätes zurück.
OutputStream As java.io.OutputStream
[read only]
Gibt den OutputStream
zurück der benutzt wird um die Daten auf das andere Gerät zu schreiben.
Muß aufgerufen werden nachdem die Verbindung erstellt ist.
StopListening
Stoppt das Abhören
auf einkommende Verbindungen.
Es löst keine aktive Verbindung.