Allgemeine Informationen
Die Klasse MobileCapture ist der Einstiegspunkt in das signoMobileCapture API. Diese Klasse übernimmt die Bonjour-Kommunikation und stellt für die gefundenen mobilen Geräte passende Instanzen der MobileDevice Klasse zur Verfügung.
MobileCapture %MOBILECAPTURE_NAME% = new MobileCapture();
Methode SetLicenseKey
Mit dieser Methode wird der hardwareunabhängige Unternehmenslizenzschlüssel gesetzt (sofern vorhanden). Hierdurch werden verschiedene Funktionen freigeschaltet und die Einblendung des Demostempels wird entfernt.
Für Fragen bezüglich des Erwerbs eines Lizenzschlüssels wenden Sie sich bitte an Ihren Kontakt bei signotec.
static void SetLicenseKey(string licenseKey)
|
Parameter |
Beschreibung |
|---|---|
|
licenseKey |
Ein gültiger Lizenzschlüssel für das „signoAPI“. |
Methode Dispose
Sofern die MobileCapture-Klasse nicht mittels eines using-Blocks instanziiert wird, muss die Dispose-Methode aufgerufen werden, sobald die Instanz nicht länger benötigt wird.
Hierdurch werden der Bonjour-Dienst gestoppt (sofern dieser vorher gestartet wurden) und weitere Aufräumarbeiten verrichtet.
void Dispose()
Methode StartService
Diese Methode startet den Bonjour-Dienst. Im Anschluss werden für alle gefundenen mobilen Geräte und alle etwaigen auftretenden Fehler die jeweiligen Events ausgelöst.
Es wird dringend empfohlen zuerst passende Handler für alle Events dieser Klasse zu registrieren und erst dann den Service zu starten!
void StartService()
Event MobileDeviceFound
Dieses Event wird immer dann aufgerufen, wenn vom laufendem Service ein mobiles Gerät gefunden wurde.
Im folgenden wird eine Beispiel-Implementation gezeigt, in der benutzerdefinierte Namen durch Platzhalter (%…%) ersetzt wurden.
%MOBILECAPTURE_NAME%.MobileDeviceFound += new MobileDeviceFoundHandler(%CALLBACK_FUNCTION%);
private void %CALLBACK_FUNCTION%(Object sender, MobileDeviceEventArgs e);
Die Klasse MobileDeviceEventArgs enthält folgende Membervariablen:
|
Membervariable |
Typ |
Beschreibung |
|---|---|---|
|
Device |
gefundenes mobiles Gerät |
Event MobileDeviceLost
Dieses Event wird immer dann aufgerufen, wenn vom laufendem Service ein zuvor gefundenes mobiles Gerät nicht länger erreichbar ist.
Im folgenden wird eine Beispiel-Implementation gezeigt, in der benutzerdefinierte Namen durch Platzhalter (%…%) ersetzt wurden.
%MOBILECAPTURE_NAME%.MobileDeviceLost += new MobileDeviceFoundHandler(%CALLBACK_FUNCTION%);
private void %CALLBACK_FUNCTION%(Object sender, MobileDeviceEventArgs e);
Die Klasse MobileDeviceEventArgs enthält folgende Membervariablen:
|
Membervariable |
Typ |
Beschreibung |
|---|---|---|
|
Device |
nicht mehr erreichbares mobiles Gerät |
Event BonjourError
Dieses Event wird immer dann aufgerufen, wenn eine der asynchronen Bonjour-Methoden einen entsprechenden Fehler meldet.
Im folgenden wird eine Beispiel-Implementation gezeigt, in der benutzerdefinierte Namen durch Platzhalter (%…%) ersetzt wurden.
%MOBILECAPTURE_NAME%.BonjourError += new BonjourErrorHandler(%CALLBACK_FUNCTION%);
private void %CALLBACK_FUNCTION%(object sender, BonjourErrorEventArgs e);
Die Klasse BonjourErrorEventArgs enthält folgende Membervariablen:
|
Membervariable |
Typ |
Beschreibung |
|---|---|---|
|
ErrorCode |
der von Bonjour gemeldete Fehlercode |
Event MobileCaptureError
Dieses Event wird immer dann aufgerufen, wenn eine asynchrone interne Methode des laufenden Services eine Ausnahme wirft.
Im folgenden wird eine Beispiel-Implementation gezeigt, in der benutzerdefinierte Namen durch Platzhalter (%…%) ersetzt wurden.
%MOBILECAPTURE_NAME%.MobileCaptureError += new MobileCaptureErrorHandler(%CALLBACK_FUNCTION%);
private void %CALLBACK_FUNCTION%(object sender, MobileCaptureErrorEventArgs e);
Die Klasse MobileCaptureErrorEventArgs enthält folgende Membervariablen:
|
Membervariable |
Typ |
Beschreibung |
|---|---|---|
|
Exception |
Exception |
die von der internen Methode geworfene Ausnahme |