Phone
Die Phone Bibliothek enthält alle Arten von Funktionalitäten im
Zusammenhang mit Android Telefongeräten.
Phone dieses Objekt enthält Informationen über das Gerät und auch andere
generelle Features.
PhoneAccelerometer gibt alle gespeicherten Nachrichten in einer Liste zurück
und PhoneOrientation Objekte sind jetzt durch PhoneSensors ersetzt,
das auch andere Sensoren unterstützt.
PhoneEvents erlaubt alle Arten von Events zu behandeln.
PhoneSms unterstützt die Sendung von Sms Nachrichten.
SmsMessages zusammen mit Sms unterstützt das Holen von Nachrichten von
der Handy Datenbank.
SmsInterceptor fängt eingehende Sms ab.
PhoneIntents und PhoneCalls enthält einige nützliche Intents.
Intent ist ein rohes Intent-Objekt das man nach Bedarf konfigurieren
kann.
Email hilft beim Erstellen von einem Intent das E-Mails sendet.
PhoneWakeState erlaubt den Bildschirm und die Stromspeisung
beizubehalten.
Contact und Contacts gibt Zugang zu den gespeicherten Kontakten.
CallLog und CallItem gibt Zugang zu den Handyanruf-Protokolle.
ContentChooser erlaubt dem Benutzer Inhalte von anderen Applikationen zu
wählen. Zum Beispiel kann der Benutzer ein Bild aus der Gallery- Applikation
wählen.
VoiceRecognition konvertiert Sprache zu Text.
LogCat erlaubt das Verfolgen der internen Telefon-Protokolle (internal
phone logs).
PackageManager erlaubt ein Abrufen der Informationen über die
installierten Applikationen.
List of Types:
CallItem
CallLog
Contact
Contacts
ContentChooser
Email
Intent
LogCat
PackageManager
Phone
PhoneAccelerometer
PhoneCalls
PhoneEvents
PhoneIntents
PhoneOrientation
PhoneSensors
PhoneSms
PhoneWakeState
Sms
SmsInterceptor
SmsMessages
VoiceRecognition
Stellt einen einzelnen Anruf im Anrufprotokoll (call logs). Siehe CallLog
für mehr Informationen.
Events:
Keine
Members:
CachedName
As String
CallType
As Int
Date
As Long
Duration
As Long
Id
As Int
Number
As String
TYPE_INCOMING
As Int
TYPE_MISSED
As Int
TYPE_OUTGOING
As Int
Members Erklärung:
Gibt den
zwischengespeicherten Name zurück der dieser Rufnummer zum Zeitpunkt des
Anrufes zugewiesene wurde.
Gibt einen leeren
String zurück, wenn kein Name zugeordnet wurde
Die Anrufart. Dieser Wert
entspricht einer der TYPE Konstanten.
Date As Long
Das Anrufdatum in Ticks
gemessen.
Duration As Long
Id As Int
Number As String
TYPE_INCOMING As Int
CallLog erlaubt die Anrufprotokolle (call logs) durchzusuchen.
Abgerufene Anrufe werden immer in absteigender
Datum-Reihenfolge sortiert
Beispiel:
Dim Calls As List
Dim CallLog As CallLog
calls = CallLog.GetAll(10) 'Get the last 10 calls
For i = 0 To calls.Size - 1
Dim c As CallItem
c = calls.Get(i)
Dim callType, name As String
Select c.CallType
Case c.TYPE_INCOMING
callType="Incoming"
Case c.TYPE_MISSED
callType
= "Missed"
Case c.TYPE_OUTGOING
callType
= "Outgoing"
End Select
name = c.CachedName
If name = "" Then name = "N/A"
Log("Number=" & c.Number & ", Name=" & name _
& ", Type=" & callType & ", Date=" &
DateTime.Date(c.Date))
Next
Permissions:
android.permission.READ_CONTACTS
Events:
Keine
Members:
GetAll
(Limit As Int) As List
GetById
(Id As Int) As CallItem
GetSince
(Date As Long, Limit As Int) As List
Members Erklärung:
Gibt alle Anrufe zurück, nach
Datum sortiert (absteigend) als Liste von CallItems.
Limit – Maximale Anzahl von zurückzugebenden CallItems. Für alle Einträge, 0
übergeben.
GetById (Id As Int) As CallItem
Gibt das CallItem mit dem
gegebenen Id zurück.
Gibt Null zurück wenn kein entsprechendes CallItem gefunden wurde.
GetSince (Date As Long, Limit As Int) As List
Gibt alle CallItems zurück
deren Datum neuer als das gegebene Datum ist.
Limit – Maximale Anzahl von zurückzugebenden CallItems. Für alle Einträge, 0
übergeben.
Stellt einen einzigen Kontakt dar.
Das Contacts Objekt sollte benutzt werden um eine Liste von Kontakten zu
bekommen.
EMAIL_x Konstanten der möglichen E-Mail Arten.
PHONE_x Konstanten der möglichen Handy Arten.
Events:
Keine
Members:
DisplayName As String
EMAIL_CUSTOM
As Int
EMAIL_HOME
As Int
EMAIL_OTHER
As Int
EMAIL_WORK
As Int
GetEmails
As Map
GetPhones
As Map
GetPhoto
As BitmapWrapper
Id
As Int
LastTimeContacted
As Long
Name
As String
Notes
As String
PHONE_CUSTOM
As Int
PHONE_FAX_HOME
As Int
PHONE_FAX_WORK
As Int
PHONE_HOME
As Int
PHONE_MOBILE
As Int
PHONE_OTHER
As Int
PHONE_PAGER
As Int
PHONE_WORK
As Int
PhoneNumber
As String
Starred
As Boolean
TimesContacted
As Int
Members Erklärung:
Der Anzeige-Name.
Entspricht dem Namen wenn dieser nicht leer ist, entspricht andernfalls der
ersten E-Mail Adresse des Kontaktes.
EMAIL_CUSTOM As Int
Gibt eine Map zurück mit den
E-Mail Adressen als Schlüssel und den E-Mail Arten als Wert.
Dieser Abruf erzeugt eine neue Abfrage.
GetPhones As Map
Gibt eine Map zurück mit den
Kontakt Telefonnummern als Schlüssel und den Geräte Arten als Wert.
Dieser Abruf erzeugt eine
neue Abfrage.
GetPhoto As BitmapWrapper
Gabt das Foto des Kontaktes
zurück, oder Null wenn kein Foto angehängt ist.
Dieser Abruf erzeugt eine neue Abfrage.
Id As Int
LastTimeContacted As Long
Letzte Zeit wenn
dieser Kontakt verbunden wurde. Als Tick-Wert.
Name As String
Notes As String
Starred As Boolean
True – wenn der Kontakt ein
Favorit-Kontakt ist.
TimesContacted As Int
Anzahl wie viel mal
der Kontakt verbunden wurde.
Das Contacts Objekt erlaubt den Zugriff auf Kontakte die im Gerät
gespeichert sind.
Der folgende Code findet alle Kontakte mit dem Namen John (in Wirklichkeit
findet der Code alle Kontakte deren Name den String "john" enthält)
und druckt die Felder zum LogCat. Es sucht auch nach dem Kontakt-Foto wenn es
existiert.
Beispiel:
Dim Contacts1 As Contacts
Dim listOfContacts As List
listOfContacts = Contacts1.FindByName("John", False)
For i = 0 To
listOfContacts.Size - 1
Dim
Contact As Contact
Contact = listOfContacts.Get(i)
Log(Contact) 'will print the fields to the LogCat
Dim photo As Bitmap
photo = Contact.GetPhoto
If photo
<> Null Then
Activity.SetBackgroundImage(photo)
Dim
emails As Map
emails = Contact.GetEmails
If
emails.Size > 0 Then Log("Email
addresses: "
& emails)
Dim
phones As Map
phones = Contact.GetPhones
If
phones.Size > 0 Then Log("Phone
numbers: "
& phones)
Next
Permissions:
android.permission.READ_CONTACTS
Events:
Keine
Members:
FindByMail
(Email As String, Exact As Boolean) As List
FindByName
(Name As String, Exact As Boolean) As List
GetAll
As List
GetById
(Id As Int) As Contact
Members Erklärung:
FindByMail (Email As String, Exact As Boolean) As List
Gibt eine Liste von
Contact Objekten mit allen Kontakten mit dem gegebenen E-Mail zurück.
Email – Das zu suchende E-Mail.
Exact - Wenn True dann werden nur die Kontakte zurück gegeben die genau der
E-Mail Adresse entsprechen (Klein- und Großchreibung empfindlich), andernfalls
werden alle Kontakte zurück gegeben deren E-Mail Adresse den E-Mail Sting
enthält (Klein- und Großchreibung unempfindlich).
FindByName (Name As String, Exact As Boolean) As List
Gibt eine Liste von
Contact Objekten mit allen Kontakten mit dem gegebenen Namen zurück.
Name – Der zu suchende Name.
Exact - Wenn True dann werden nur die Kontakte zurück gegeben die genau dem
Namen entsprechen (Klein- und Großchreibung empfindlich), andernfalls werden
alle Kontakte zurück gegeben deren Name den Name Sting enthält (Klein- und Großchreibung
unempfindlich).
GetAll As List
Gibt eine Liste von Contact
Objekten mit allen Kontakten zurück. Diese Liste kann sehr groß werden.
GetById (Id As Int) As Contact
Gibt den Kontakt mit dem
gegebenen Id zurück.
Gibt Null zurück wenn kein Kontakt gefunden wurde.
Das ContentChooser Objekt erlaubt dem Benutzer, eine bestimmte Art von
Inhalten mit anderen installierten Anwendungen zu wählen.
Zum Beispiel kann der Anwender die interne Anwendung Galerie benutzen um
ein Bild auszuwählen.
Wenn der Benutzer einen Dateimanager installiert hat kann er mit dem
ContentChooser allgemeine Dateien auswählen.
Dieses Objekt sollte in der Regel als ein Prozess globales Objekt
deklariert werden.
Nach der Initialisierung des Objekts können Sie den Benutzer mit
Content.Show den Inhalt mit den erforderlichen MIME-Typen aufrufen lassen.
Das Ergebnis Event wird ausgelöst mit einem Success Flag (Erfolg Flagge)
und mit dem Inhalt das heisst Ordner und Dateiname.
Beachten Sie, daß diese Inhalt-Werte können auch auf andere Resourcen
zeigen können als reguläre Dateien. Man kann sie jedoch immer noch an Methoden
übergeben die Ordner (Dir) und Dateiname erwarten.
Nur Content-Typen, die mit einem InputStream geöffnet werden können, sind
unterstützt.
Events:
Result (Success As Boolean, Dir As String, FileName As String)
Members:
Initialize
(EventName As String)
Show
(Mime As String, Title As String)
Members Erklärung:
Initialize (EventName As String)
Initialisiert das
Objekt und definiert die Subroutine die dessen Events behandelt.
Beispiel:
Dim CC As ContentChooser
CC.Initialize("CC")
Show (Mime As String, Title As String)
Sendet die Anfrage an
das System. Falls mehr als eine Applikation das gegebene MIME erkennen wird
eine Liste dieser Applikationen angezeigt.
Das Result Event wird ausgelöst sobald der Benutzer einen Eintrag gewählt hat
oder den Dialog abgebrochen hat.
Mime - Der Content MIME Type.
Title - Title des Chooser Dialogs (wenn mehr als eine Applikation zur Verfügung
stehen).
Beispiele:
CC.Show("image/*", "Choose
image")
CC.Show("audio/*", "Choose audio
file")
Das Email Objekt erlaubt ein Intent zu erstellen das eine komplette E-Mail
Nachricht enthält.
Man kann dann die E-Mail Applikation starten in dem man StartActivity aufruft.
Beachten Sie daß das E-Mail nicht automatisch abgesendet wird. Der Benutzer muß
den Send Button drücken.
Beispiel:
Dim Message As Email
Message.To.Add("SomeEmail@example.com")
Message.Attachments.Add(File.Combine(File.DirRootExternal, "SomeFile.txt"))
StartActivity(Message.GetIntent)
Events:
Keine
Members:
Attachments
As List
BCC
As List
Body
As String
CC
As List
GetIntent
Als
Android.Content.Intent
Subject
As String
To As List
Members Erklärung:
GetIntent As android.content.Intent
Gibt das Intent zurück das
mit StartActivity gesendet werden muß.
Subject As String
Intent Objekte sind Nachrichten (messages) die man an das OS senden kann um
externe Tätigkeiten auszuführen.
Das Intent Objekt muß mit dem StartActivity Schlüsselwort gesendet
werden.
Siehe diese Seite
für eine Liste von Standardkonstanten.
Beispiel, YouTube Applikation starten:
Dim Intent1 As Intent
Intent1.Initialize(Intent1.ACTION_MAIN, "")
Intent1.SetComponent("com.google.android.youtube/.HomeActivity")
StartActivity(Intent1)
Events:
Keine
Members:
ACTION_CALL As String
ACTION_EDIT
As String
ACTION_MAIN
As String
ACTION_PICK
As String
ACTION_SEND
As String
ACTION_VIEW
As String
AddCategory
(Category As String)
ExtrasToString
As String
Flags
As Int
GetData
GetExtra
(Name As String)
As Object
HasExtra
(Name As String)
As Boolean
Initialize
(Action As String,
Uri As String)
Initialize2
(Uri As String,
Flags As Int)
IsInitialized
As Boolean
PutExtra
(Name As String,
Value As Object)
SetComponent
(Component As String)
SetType
(Type As String)
WrapAsIntentChooser
(Title As String)
Members Erklärung:
AddCategory (Category As String)
Fügt eine Kategorie an die
das Intent beschreibt.
ExtrasToString As String
Gibt einen String
zurück der extra Einträge enthält. Das ist für Debugging sehr nützlich.
Flags As Int
Holt oder setzt die Flagge
(flag) Komponente.
GetData
Holt die Daten-Komponente als
String ab.
GetExtra (Name As String) As Object
Gibt den Eintrag mit dem
gegebenen Schlüssel (key) zurück.
HasExtra (Name As String) As Boolean
Testet ob ein Eintrag mit dem
gegebenen Schlüssel existiert.
Initialize (Action As String, Uri As String)
Initialisiert das Objekt mit
dem gegebenen Action Parameter und dem Daten-Uri. Action kann eine von den
Action-Konstanten sein oder jeder andere String.
Einen leeren String übergeben wenn der Uri nicht nötig ist.
Initialize2 (Uri As String, Flags As Int)
Initialisiert das Objekt mit
dem Uri.
Flags – Zusätzlicher Integer Wert. 0 übergeben wenn nicht nötig.
Beispiel:
Dim Intent1 As Intent
Intent1.Initialize2("http://www.basic4ppc.com", 0)
StartActivity(Intent1)
IsInitialized As Boolean
PutExtra (Name As String, Value As Object)
Fügt extra Daten an das
Intent an.
SetComponent (Component As String)
Setzt explizit die
gegebene Komponente (Component) die Intent
behandeln wird.
SetType (Type As String)
Setzt den MIME Type.
Beispiel:
Intent1.SetType("plain/text")
WrapAsIntentChooser (Title As String)
Übergibt den Intent
in ein anderes "chooser" Intent. Ein Dialog wird angezeigt mit den
zur Verfügung stehenden Services die auf das Intent einwirken können.
WrapAsIntentChooser sollte die letzte Methode sein die vor dem Senden des
Intents aufgerufen wird.
LogCat erlaubt Ihnen die internen Telefon-Logs (Protokolle) zu lesen.
Siehe in LogCat
documentation für mehr Information über optionale Argumente.
Das LogCatData Event wird ausgelöst wenn neue Daten zur Verfügung stehen.
Sie müssen BytesToString benutzen um die rohen Daten zu einem String zu
konvertieren.
Permissions:
android.permission.READ_LOGS
Events:
LogCatData (Buffer() As Byte, Length As Int)
Members:
LogCatStart
(Args() As String, EventName As String)
LogCatStop
Members Erklärung:
LogCatStart (Args() As String, EventName As String)
Startet die Überwachung der
Logs.
Args - Optionale Argumente die der internen LogCat Funktion übergeben werden.
EventName – Name der Subroutine die das LogCatData Event behandelt.
LogCatStop
Stoppt die Logs Überwachung.
Der PackageManager erlaubt Ihnen Informationen über installierte
Applikationen zu finden.
Applikationen sind mit ihren Packagenamen angegeben.
Sie können eine Liste mit allen Packages bekommen durch einen Aufruf von
GetInstalledPackages.
Events:
Keine
Members:
GetApplicationIcon
(Package As String) As
android.graphics.drawable.Drawable
GetApplicationIntent
(Package As String) As Intent
GetApplicationLabel
(Package As String) As String
GetInstalledPackages
As List
GetVersionCode
(Package As String) As Int
GetVersionName
(Package As String) As String
Members Erklärung:
GetApplicationIcon (Package As String) As android.graphics.drawable.Drawable
Gibt das
Applications-Icon zurück.
Beispiel:
Dim pm As PackageManager
Activity.Background = pm.GetApplicationIcon("com.google.android.youtube")
GetApplicationIntent (Package As String) As Intent
Gibt ein Intent
Objekt zurück das benutzt werden kann um die gegebene Applikation zu starten.
Beispiel:
Dim in As Intent
Dim pm As PackageManager
in = pm.GetApplicationIntent("com.google.android.youtube")
If in.IsInitialized Then StartActivity(in)
StartActivity(in)
GetApplicationLabel (Package As String) As String
Gibt das Label der
gegebenen Applikation zurück.
GetInstalledPackages As List
Gibt eine Liste mit
den installierten Applikationen zurück.
Beispiel:
Dim pm As PackageManager
Dim packages As List
packages = pm.GetInstalledPackages
For i = 0 To packages.Size - 1
Log(packages.Get(i))
Next
GetVersionCode (Package As String) As Int
Gibt den
Versions-Code der Applikation zurück.
GetVersionName (Package As String) As String
Gibt den
Versions-Namen der Applikation zurück.
Permissions:
android.permission.READ_PHONE_STATE
android.permission.VIBRATE
Events:
Keine
Members:
GetDataState As String
GetDeviceId
As String
GetLine1Number
As String
GetMaxVolume
(Channel As Int)
As Int
GetNetworkOperatorName
As String
GetNetworkType
As String
GetPhoneType
As String
GetResourceDrawable
(ResourceId As Int)
As android.graphics.drawable.Drawable
GetRingerMode
As Int
GetSettings
(Settings As String)
As String
GetSimOperator
As String
GetSimSerialNumber
As String
GetSubscriberId
As String
GetVolume
(Channel As Int)
As Int
IsAirplaneModeOn
As Boolean
IsNetworkRoaming
As Boolean
Manufacturer
As String
[read only]
Model
As String
[read only]
Product
As String
[read only]
RINGER_NORMAL
As Int
RINGER_SILENT
As Int
RINGER_VIBRATE
As Int
SdkVersion
As Int
[read only]
SetMute
(Channel As Int,
Mute As Boolean)
SetRingerMode
(Mode As Int)
SetScreenBrightness
(Value As Float)
SetScreenOrientation
(Orientation As Int)
SetVolume
(Channel As Int,
VolumeIndex As Int,
ShowUI As Boolean)
Shell
(Command As String,
Args() As String,
StdOut As StringBuilder,
StdErr As StringBuilder)
As Int
Vibrate
(TimeMs As Long)
VOLUME_ALARM
As Int
VOLUME_MUSIC
As Int
VOLUME_NOTIFICATION
As Int
VOLUME_RING
As Int
VOLUME_SYSTEM
As Int
VOLUME_VOICE_CALL
As Int
Members Erklärung:
Gibt den aktuellen Status des
Telephons zurück.
Mögliche Werte: DISCONNECTED, CONNECTING, CONNECTED, SUSPENDED.
NICHT ANGESCHLOSSEN, SCHLIESST SICH
AN, ANGESCHLOSSEN, EINGESTELLT
GetDeviceId As String
Gibt einen einzigen Geräte-Id
zurück.
GetLine1Number As String
Gibt die
Telefonnummer der 1. Linie als String zurück die in der SIM Karte konfiguriert
ist.
Gibt einen leeren String zurück wenn nicht verfügbar.
GetMaxVolume (Channel As Int) As Int
Gibt den maximalen Lautstärke
Index (Wert) für den gegebenen Kanal zurück.
Channel – Eine der VOLUME-Konstanten.
GetNetworkOperatorName As String
Gibt den Namen des
aktuell registrierten Operators zurück.
Gibt einen leeren String zurück wenn nicht verfügbar.
GetNetworkType As String
Gibt den aktuell
benutzten Netzwerk-Type zurück.
Mögliche Werte: 1xRTT, CDMA, EDGE, EVDO_0, EVDO_A, EVDO_B, GPRS, HSDPA,
HSPA, HSUPA, IDEN, UMTS, UNKNOWN.
GetPhoneType As String
Gibt den Radio-Type des
Gerätes zurück. Mögliche Werte: CDMA, GSM, NONE.
GetResourceDrawable (ResourceId As Int) As
android.graphics.drawable.Drawable
Gibt ein internes
Drawable Objekt zurück.
Siehe diese Seite
für eine Liste von verfügbaren Resourcen.
Beispiel:
Dim p As Phone
Dim bd As BitmapDrawable
bd = p.GetResourceDrawable(17301618)
Activity.AddMenuItem2("Menu1", "Menu1", bd.Bitmap)
GetRingerMode As Int
Gibt den Geräte
Ringer Modus (Klingel-Modus) zurück.
Wert ist eine der RINGER-Konstanten.
GetSettings (Settings As String) As String
Gibt den Wert der
Geräte-Einstellung für den gegeben Schlüssel zurück.
Die möglichen Schlüssel sind hier
aufgelistet.
Die Schlüssel sind in kleingeschrieben.
Beispiel:
Dim p As Phone
Log(GetSettings("android_id"))
GetSimOperator As String
Gibt den Code des SIM
Providers zurück.
Gibt einen leeren String zurück wenn nicht verfügbar.
GetSimSerialNumber As String
Gibt die Seriennummer
der SIM-Karte zurück.
Gibt einen leeren String zurück wenn nicht verfügbar.
GetSubscriberId As String
Gibt den einzigen
Subscriber-Id zurück.
Gibt einen leeren String zurück wenn nicht verfügbar.
GetVolume (Channel As Int) As Int
Gibt die Lautstärke des gegebenen
Kanals zurück.
Channel – Eine der VOLUME-Konstanten.
IsAirplaneModeOn As Boolean
Testet ob der
"airplane mode" eingeschaltet ist.
IsNetworkRoaming As Boolean
Gibt True zurück wenn
das Gerät auf dem aktuellen Netzwerk 'roamt' 'roaming'.
Manufacturer As String [read only]
RINGER_SILENT As Int
Die Klingel bleibt
stumm und vibriert nicht.
RINGER_VIBRATE As Int
Gerät-Klingel
vibriert, bleibt aber stumm.
SdkVersion As Int [read only]
Gibt einen Integer zurück mit
der SDK Version.
SetMute (Channel As Int, Mute As Boolean)
Setzt den gegebenen Kanal zu
stumm, Mute = True oder aktiv Mute = False .
Channel - Eine der VOLUME-Konstanten.
Mute – True = stumm False = aktiv.
SetRingerMode (Mode As Int)
Setzt den
Geräte-Läute-Modus.
Mode – Eine der RINGER-Konstanten.
Beispiel:
Dim p As Phone
p.SetRingerMode(p.RINGER_VIBRATE)
SetScreenBrightness (Value As Float)
Setzt die Helligkeit
der aktuellen Activity. Diese Methode kann nicht von einem Service aufgerufen
werden.
Value – Ein Float Wert zwischen 0 bis 1.
-1 eingeben für automatische Helligkeit.
Beispiel:
Sub Process_Globals
Dim phone1 As Phone
End Sub
Sub Globals
Dim sb As SeekBar
End Sub
Sub Activity_Create(FirstTime As Boolean)
sb.Initialize("sb")
sb.Max = 100
sb.Value = 50
Activity.AddView(sb, 10dip, 10dip, 90%x, 30dip)
End Sub
Sub sb_ValueChanged (Value As Int,
UserChanged As Boolean)
phone1.SetScreenBrightness(Max(Value, 5) / 100)
End Sub
SetScreenOrientation (Orientation As Int)
Ändert die
Orientierung der aktuellen Activity. Diese Methode kann nicht von einem Service
Modul aufgerufen werden.
Orientation - -1 für nicht spezifiziert, 0 für Landschaft (waagrecht) und 1 für
Portrait (senkrecht).
SetVolume (Channel As Int, VolumeIndex As Int, ShowUI As Boolean)
Setzt die Lautstärke des
gegebenen Kanals.
Channel - Eine Lautstärke der VOLUME-Konstanten.
VolumeIndex – Der Lautstärke-Index. GetMaxVolume kann benutzt werden um den größtmöglichen
Wert zu bekommen.
ShowUI – Das Lautstärke UI Fenster anzeigen oder nicht.
Beispiel:
Dim p As Phone
p.SetVolume(p.VOLUME_MUSIC, 3, True)
Shell (Command As String, Args() As String, StdOut As StringBuilder, StdErr As StringBuilder) As Int
Führt einen nativen Shell
Befehl aus. Viele Befehle können nicht ausgeführt werden wegen OS Sicherheitsbeschränkungen.
Command – Auszuführender Befehl.
Args – Zusätzliche Argumente. Kann Null sein wenn nicht benötigt.
StdOut - Ein StringBuilder der den Standard Ausgabewert enthält. Kann Null sein
wenn nicht benötigt.
StdErr - Ein StringBuilder der den Standard Fehlerwert enthält. Kann Null sein
wenn nicht benötigt.
Gibt den Prozess Ausgangswert (exit value) zurück.
Beispiel:
Dim p As Phone
Dim sb As StringBuilder
sb.Initialize
p.Shell("df", Null, sb, Null)
Msgbox(sb.ToString, "Free space:")
Vibrate (TimeMs As Long)
Lässt das Gerät für die gegebene
Dauer vibrieren.
TimeMs – Dauer in ms
(milli-Sekunden)
VOLUME_ALARM As Int
VOLUME_MUSIC As Int
VOLUME_NOTIFICATION As Int
Notifications
channel. Nachrichten-Kanal
VOLUME_RING As Int
Phone ring channel. Geräte Läute-Kanal
VOLUME_SYSTEM As Int
System sounds
channel. System Ton-Kanal
VOLUME_VOICE_CALL As Int
Voice calls channel.
Sprache-Kanal
Diese Objekt gibt Zugriff auf die Beschleunigungssensoren (accelerometers
sensors).
Siehe das Orientation
and accelerometers Beispiel.
Dieses Objekt sollte als Prozess globales Objekt (process global object)
deklariert werden.
Events:
AccelerometerChanged (X As Float, Y As Float, Z As Float)
Members:
StartListening
(EventName As String)
StopListening
Members Erklärung:
StartListening (EventName As String)
Startet das Abwarten
auf das AccelerometerChanged Events.
StopListening
Stoppt das Abwarten
auf Events.
Dieses Objekt erstellt ein Intent das eine Applikation (phone application)
startet.
Der Grund warum es nicht in der PhoneIntents Bibliothek enthalten ist, ist daß
dieses Intent eine zusätzliche Erlaubniss (permission) braucht.
Permissions:
android.permission.CALL_PHONE
Events:
Keine
Members:
Call
(PhoneNumber As
String) As android.content.Intent
Members Erklärung:
Call (PhoneNumber As String) As android.content.Intent
Erstellt ein Intenet das eine
Telefonnummer ruft.
Beispiel:
Dim p As PhoneCalls
StartActivity(p.Call("1234567890"))
Das Android OS sendet alle Arten von Nachrichten die Applikationen
Änderungen im System melden.
Das PhoneEvents Objekt erlaubt Ihnen solche Nachrichten abzufangen um diese
Events zu behandeln.
Normalerweise Fügt man dieses Objekt in einem Service Modul hinzu anstatt in
einem Activity Modul um sicher zu stellen daß man keines dieser Events vermisst
wenn die Acitivty gestoppt (paused) ist.
Das Arbeiten mit diesem Objekt ist sehr einfach. Sie müssen das Objekt in Sub
Process_Globals deklarieren und in Service_Create initialisieren.
Ab jetzt werden die deklarierten Sub Events behandelt.
Das Intent Objekt das vom System gesendet wurde ist als letzter Parameter
übergeben.
Die unterstützen Events sind:
AirplaneModeChanged – Wird ausgelöst wenn sich der "airplane
mode" Status geändert hat.
State - True wenn der "airplane mode" aktiv ist.
BatteryChanged - Wird ausgelöst wenn sich der Battery Status geändert
hat.
Level – Der aktuelle Stand.
Scale – Der Höchstwert.
Plugged – Gibt an ob das Gerät an einer elektrischen Quelle angeschlossen ist.
ConnectivityChanged - Wird ausgelöst wenn sich der WIFI Netzwerk oder
MOBILE Netzwerk (anderes Netzwerk) Status geändert hat.
NetworkType - WIFI oder MOBILE.
State – Einer der folgenden Werten: CONNECTING, CONNECTED, SUSPENDED,
DISCONNECTING, DISCONNECTED, UNKNOWN.
Schliesst sich an, Angeschlossen,
Aufgehoben, Stellt sich ab, Abgestellt, Unbekannt
DeviceStorageLow – Der interne Speicherplatz ist gering.
DeviceStorageOk - Der geringe interne Speicherplatz Status ist
aufgehoben.
PackageAdded – Eine Applikation wurde installiert.
Package - Der Application Package Name.
PackageRemoved - Eine Applikation wurde de installiert.
Package - Der Application Package Name.
PhoneStateChanged – Der Geräte Status hat sich geändert.
State – Einer dieser drei Werte: IDLE, OFFHOOK, RINGING. Der OFFHOOK
(abgehängt) Parameter heißt daß ein Ruf ankommt oder daß das Gerät eine Nummer
wählt.
ruhend,
abgehängt, klingelt
IncomingCall – Steht zur Verfügung wenn der Status Wert RINGING (klingelt)
ist.
ScreenOff – Der Bildschirm wurde ausgeschalten.
ScreenOn - Der Bildschirm wurde angeschalten.
Shutdown – Das Gerät schaltet sich aus (ausschalten nicht schlummern).
TextToSpeechFinish – Das Text To Speech Engine ist mit der Ausgabe aus
der Warteschlaufe fertig.
UserPresent – Der Benutzer hat den Bildschirm entriegelt.
Permissions:
android.permission.READ_PHONE_STATE
Events:
AirplaneModeChanged (State As Boolean, Intent As
Intent)
BatteryChanged (Level As Int, Scale As Int, Plugged As Boolean, Intent As
Intent)
ConnectivityChanged (NetworkType As String, State As String, Intent As Intent)
DeviceStorageLow (Intent As Intent)
DeviceStorageOk (Intent As Intent)
PackageAdded (Package As String, Intent As Intent)
PackageRemoved (Package As String, Intent As Intent)
PhoneStateChanged (State As String, IncomingNumber As String, Intent As Intent)
ScreenOff (Intent As Intent)
ScreenOn (Intent As Intent)
Shutdown (Intent As Intent)
TextToSpeechFinish (Intent As Intent)
UserPresent (Intent As Intent)
Members:
Initialize
(EventName As String)
StopListening
Members Erklärung:
Initialize (EventName As String)
Initialisiert das
Objekt und startet das abhören auf Events.
StopListening
Stoppt das Abwarten
auf Events. Sie können später Initialize aufrufen um Event wieder abzuhören.
Dieses Objekt enthält Methoden die Intent Objekte erstellen. Ein Intent
macht nichts solange man nicht StartActivity, mit dem Intent aufgerufen hat.
Das aufrufen von StartActivity sendet dem OS diese Intent.
Events:
Keine
Members:
OpenBrowser
(Uri As String) As android.content.Intent
PlayAudio
(Dir As String, File As String) As android.content.Intent
PlayVideo
(Dir As String, File As String) As android.content.Intent
Members Erklärung:
OpenBrowser (Uri As String) As android.content.Intent
Erstellt ein Intent
das den gegebenen URI öffnet.
Beispiel:
StartActivity (PhoneIntents.OpenBrowser("http://www.google.com"))
PlayAudio (Dir As String, File As String) As android.content.Intent
Erstellt ein Intent
das den voreingestellten MediaPlayer, mit der gegebenen Audiodatei, startet.
Diese Methode funktioniert nicht mit internen Dateien.
PlayVideo (Dir As String, File As String) As android.content.Intent
Erstellt ein Intent
das den voreingestellten MediaPlayer, mit der gegebenen Videodatei, startet.
Diese Methode funktioniert nicht mit internen Dateien.
Dieses Objekt erlaubt den Zugriff auf die internen Orientierungssensoren.
Siehe das Orientation
and accelerometers Beispiel.
Dieses Objekt sollte als Prozess globales Objekt (process global object)
deklariert werden.
Events:
OrientationChanged (Azimuth As Float, Pitch As Float, Roll As Float)
Members:
StartListening
(EventName As String)
StopListening
Members Erklärung:
StartListening (EventName As String)
Startet das abhören
auf OrientationChanged Events.
StopListening
Stoppt das Abwarten
auf Events.
Das PhoneSensors Objekt erlaubt das Abhören auf Änderungen in einem der
Gerätesensoren.
Siehe das Sensor
Beispiel.
Die meisten Geräte unterstützen nicht alle Sensoren. Die StartListening Methode
gibt False zurück wenn der gegebene Sensor nicht unterstützt ist.
Nach dem Initialisieren des Objektes und dem Aufruf von StartListening, wird
das SensorChanged Event jedes mal ausgelöst wenn sich Sensorwerte ändern.
Die Werte "Values()" werden in einem Float Array übergeben. Mache Sensoren
geben einen einzigen Wert zurück und Andere geben drei Werte zurück.
Events:
SensorChanged (Values() As Float)
Members:
Initialize
(SensorType As
Int)
Initialize2
(SensorType As
Int,
SensorDelay As
Int)
MaxValue
As Float [read only]
StartListening
(EventName As String) As Boolean
StopListening
TYPE_ACCELEROMETER
As Int
TYPE_GYROSCOPE
As Int
TYPE_LIGHT
As Int
TYPE_MAGNETIC_FIELD
As Int
TYPE_ORIENTATION
As Int
TYPE_PRESSURE
As Int
TYPE_PROXIMITY
As Int
TYPE_TEMPERATURE
As Int
Members Erklärung:
Initialize (SensorType As Int)
Initialisiert das
Objekt und setzt den Sensor-Type (eine der TYPE_Konstanten).
Initialize2 (SensorType As Int, SensorDelay As Int)
Initialisiert das
Objekt und setzt den Sensor-Type mit der Abtastrate (SensorDelay).
SensorType - Eine der TYPE_Konstanten.
SensorDelay – Ein wert zwischen 0 (schnelle Abtastrate) bis 3 (langsamste
Abtastrate). Dies sind nur Richtwerte für das System.
MaxValue As Float [read only]
Gibt den maximalen
Wert des Sensors zurück.
Gibt -1 zurück wenn der Sensor nicht unterstützt ist.
StartListening (EventName As String) As Boolean
Startet das abhören auf
Events.
Gibt True zurück wenn der gegebene Sensor auf dem Gerät existiert.
Normalerweise startet man das Abhören in Sub Activity_Resume und stoppt das
Abhören in Sub Activity_Pause.
StopListening
Stoppt das Abwarten
auf Events.
TYPE_ACCELEROMETER As Int
Drei Werte –
Beschleunigung in m/s2 (Meter / Sekunde ^ 2) für jede Achse (X, Y
und Z).
TYPE_GYROSCOPE As Int
Drei Werte –
Winkelgeschwindigkeit in Rad/s Radian / Sekunde um jede Achse.
TYPE_LIGHT As Int
Ein einziger Wert –
Umgebungslichtstärke in Lux (SI Einheit).
TYPE_MAGNETIC_FIELD As Int
Drei Werte –
Umgebendes magnetische in mTesla (micro-Tesla) für die
X, Y und Z Achsen.
TYPE_ORIENTATION As Int
Drei Werte – Orientierung
in Azimuthgrad gemessen, Azimut, Pich und Roll.
TYPE_PRESSURE As Int
Ein einziger Wert -
Luftdruck.
TYPE_PROXIMITY As Int
Ein einziger Wert –
Nähe in cm (Zentimeter). Die meißten Geräte geben nur zwei mögliche Werte
zurück die "nah" oder "fern" bedeuten.
"fern" sollte dem MaxRange Wert gleich sein
und "nah" sollte ein Wert kleiner als MaxRange sein.
TYPE_TEMPERATURE As Int
Ein einziger Wert -
Umgebungstemperatur.
Permissions:
android.permission.SEND_SMS
Events:
Keine
Members:
Send
(PhoneNumber As
String,
Text As String)
Members Erklärung:
Send (PhoneNumber As String, Text As String)
Sendet ein Sms. Beachten Sie daß
diese Methode das SMS sofort sendet (im Gegensatz zu anderen Methoden die ein
Intent Objekt erstellen).
Das PhoneWakeState Objekt erlaubt Ihnen das Ausschalten des Bildschirms zu
vermeiden.
Nach dem Aufruf von KeepAlive bleibt der Bildschirm solange aktiv bis Sie ReleaseKeepAlive
aufrufen.
Es ist wichtig diese Funktion aufzuheben.
Eine empfohlene Benutzung ist der Aufruf von KeepAlive in Activity_Resume und der
Aufruf von ReleaseKeepAlive in Activity_Pause.
Beachten Sie daß der Benutzer dennoch den Bildschirm, durch drücken des Power
Buttons, ausschalten kann.
Ein Aufruf von PartialLock verhindert daß die CPU in Ruhestand geht auch wenn
der Benutzer auf den Power Button drückt.
Dies hat aber keinen Einfluß auf den Bildschirm.
Permissions:
android.permission.WAKE_LOCK
Events:
Keine
Members:
KeepAlive
(BrightScreen As
Boolean)
PartialLock
ReleaseKeepAlive
ReleasePartialLock
Members Erklärung:
KeepAlive (BrightScreen As Boolean)
Verhindert daß das
Gerät in Ruhestand geht.
ReleaseKeepAlive aufrufen um die Funktion aufzuheben.
BrightScreen – Bildschirm aktiv (True) lassen oder ausschalten (False).
PartialLock
Erzeugt eine
Teilsperrung (partial lock). Dies verhindert daß das Gerät in Ruhestand geht, auch
wenn der Benutzer auf den Power Button drückt.
Versichern Sie sich daß ReleasePartialLock aufgerufen wird um diese Sperrung
aufzuheben.
ReleaseKeepAlive
Hebt die PowerLock Funktion
auf und erlaubt dem Gerät in Ruhestand zu gehen.
ReleasePartialLock
Hebt die Teilsperrung
(partial lock) Funktion auf die zuvor mit PartialLock aktiviert wurde.
Entspricht einer SMS Nachricht.
SMS Nachrichten werden mit dem SmsMessages Objekt behandelt.
Events:
Keine
Members:
Address
As String
Body
As String
Date
As Long
Id
As Int
PersonId
As Int
Read
As Boolean
ThreadId
As Int
Type As Int
Members Erklärung:
Body As String
Date As Long
Id As Int
PersonId As Int
Der Id der Person die die Nachricht
gesendet hat.
Ist -1 wenn dieser Wert nicht zur Verfügung steht.
Sie können mehr Information über diese Person bekommen durch einen Aufruf von Contacts.GetById.
Read As Boolean
Gibt an ob die Nachricht
schon gelesen wurde.
ThreadId As Int
Type As Int
Die Nachricht-Art. Wert eine
der SmsMessages Konstanten.
Hört nach einkommenden SMS Nachrichten.
Das MessageReceived Event wird ausgelöst wenn eine neue Nachricht einkommt.
Permissions:
android.permission.RECEIVE_SMS
Events:
MessageReceived (From As String, Body As String)
Members:
Initialize
(EventName As String)
StopListening
Members Erklärung:
Initialize (EventName As String)
Initialisiert das Objekt
und startet das Abhören von Nachrichten.
StopListening
Stoppt das Abhören. Sie
können später Initialize aufrufen um das Abhören wieder zu aktivieren.
Erlaubt Zugriff auf die gespeicherten SMS Nachrichten.
Beachten Sie daß man SMS Nachrichten mit PhoneSms senden kann.
Beispiel zum drucken einer Nachricht der letzten Woche:
Dim SmsMessages1 As SmsMessages
Dim List1 As List
List1 = SmsMessages1.GetAllSince(DateTime.Add(DateTime.Now, 0, 0, -7))
For i = 0 To List1.Size - 1
Dim Sms As Sms
Sms = List1.Get(i)
Log(Sms)
Next
Permissions:
android.permission.READ_SMS
Events:
Keine
Members:
GetAll As
List
GetAllSince
(Date As Long)
As List
GetBetweenDates
(StartDate As Long,
EndDate As Long)
As List
GetByPersonId
(PersonId As Int)
As List
GetByThreadId
(ThreadId As Int)
As List
GetByType
(Type As Int) As List
GetUnreadMessages
As List
TYPE_DRAFT
As Int
TYPE_FAILED
As Int
TYPE_INBOX
As Int
TYPE_OUTBOX
As Int
TYPE_QUEUED
As Int
TYPE_SENT
As Int
TYPE_UNKNOWN
As Int
Members Erklärung:
Gibt alle gespeicherten
Nachrichten in einer Liste zurück.
GetAllSince (Date As Long) As List
Gibt alle Nachrichten,
seit dem gegebenen Datum, zurück.
GetBetweenDates (StartDate As Long, EndDate As Long) As List
Gibt alle Nachrichten,
zwischen den beiden gegebenen Daten, zurück. StartDate ist inclusiv und EndDate
ist exclusiv.
GetByPersonId (PersonId As Int) As List
Gibt alle Nachrichten
von einer Person mit dem gegebenen Id in einer Liste zurück.
GetByThreadId (ThreadId As Int) As List
Gibt alle Nachrichten
mit dem gegebenen ThreadId in einer Liste zurück.
GetByType (Type As Int) As List
Gibt alle Nachrichten
mit dem gegebenen Type (Art) in einer Liste zurück. Der Typewert muß einer der Type
Konstanten sein.
GetUnreadMessages As List
Gibt alle nicht
gelesenen Nachrichten in einer Liste zurück.
TYPE_DRAFT As Int
Die meißten Android Geräte unterstützen Spracherkennung (speech to text). Meißtens
arbeitet dieser Service indem er einen Audiostream einem externen Server
zusendet der den Stream analysiert und ein mögliches Resultat zurück gibt.
Das Arbeiten mit diesem Objekt ist sehr einfach.
Sie müssen ein VoiceRecognition Objekt als ein Process globales Objekt deklarieren
und in Activity_Create initialisieren, wenn FirstTime True ist.
Später wenn Sie Listen aufrufen wird ein Dialog angezeigt, der den Benutzer auffordert
zu sprechen. Das Result Event wird ausgelöst mit dem Success Flag und einer Liste
mit den möglichen Resultaten (normalerweise ein Resultat).
Events:
Result (Success As Boolean, Texts As List)
Members:
Initialize
(EventName As String)
IsSupported
As Boolean
Language
As String [write only]
Listen
Prompt
As String [write only]
Members Erklärung:
Initialize (EventName As String)
Initialisiert das Objekt
und setzt den Namen der Subroutine die das Ready Event abfängt.
Beispiel:
Dim VR As VoiceRecognition
VR.Initialize("VR")
IsSupported As Boolean
Testet ob die
Spracherkennung vom Gerät unterstützt wird.
Language As String [write only]
Setzt die zu
verwendende Sprache. Normalerweise wird die vordefinierte Spreche benutzt.
Beispiel:
VR.Language = "en"
Listen
Startet das Abhören. Das
Ready Event wird ausgelöst wenn ein Resultat eintrifft.
Prompt As String [write only]
Setzt die
Aufforderungsmeldung (prompt) die im "Speak now" Dialog angezeigt
wird als Zugabe zur "Speak now" Meldung.