Deep Links
Der Android Mobile Client unterstützt das Öffnen von Deep Links. Damit kann z.B. aus einem Browser heraus per Link der Mobile Client geöffnet und automatisch ein Login an einem Broker ausgeführt werden. Zudem kann der Broker-Liste ein Eintrag hinzugefügt werden.
Beispiel im HTML:
<a href="fsbroker://framework-systems.de?name=Demo&url=http%3A%2F%2FAwesomeServer%3A8080%2FAwesomeApplication&login=true&save=true">Open Deep Link</a>
Der Link beginnt immer mit der Custom-Url fsbroker://framework-systems.de. Diese wird vom Mobile Client im Android-System registriert und sorgt für das Öffnen der App. Zusätzlich kann die Url aus bis zu vier der folgenden Parameter bestehen:
| Parameter | Typ | Benötigt | Funktion |
|---|---|---|---|
name |
string (url-encoded) |
Ja | Der Name des Brokers |
url |
string (url-encoded) |
Ja | Die Broker-Url |
login |
boolean (true/false) |
Nein | Steuert, ob sich die App nach dem Öffnen sofort am gegebenen Broker angemelden soll. Bei false wird lediglich die Startseite angezeigt. Der Standardwert ist true. |
save |
boolean (true/false) |
Nein | Steuert, ob der angegebene Broker in der Login-Liste des Mobile Client gespeichert werden soll. Existiert ein Eintrag mit demselben namen, so wird dessen Url überschrieben. Der Standardwert ist false. |
Die Parameter name und url müssen immer url-enkodiert sein. So muss wie im Beispiel statt
http://AwesomeServer:8080/AwesomeApplication
die url-enkodierte Variante
http%3A%2F%2FAwesomeServer%3A8080%2FAwesomeApplication
angegeben werden.
Einen entsprechenden Url-Encoder finden Sie z.B. unter https://www.urlencoder.org
Note
Ein Klick auf einen Deep Link wird vom Mobile Client nur dann interpretiert, wenn folgende Bedingungen erfüllt sind:
- Die App ist nicht bereits an einem Broker angemeldet
- Die App findet beim Start keine alte Session, die fortgeführt werden kann