Breadcrumbs

signoMobileCapture – Klasse MobileCapture

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.

C#
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.

C#
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.

C#
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!

C#
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.

C#
%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

MobileDevice

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.

C#
%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

MobileDevice

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.

C#
%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

BonjourErrorCode

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.

C#
%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