Dynamics 365 Remote Assist aus einer anderen App starten (Protokollaktivierung)

  • Artikel

Tipp

Dynamics 365 Remote Assist-Kunden haben jetzt Zugriff auf Remote Assist in Microsoft Teams Mobile. Nutzen Sie alle Vorteile von Teams und arbeiten Sie mit anderen Benutzern zusammen! Für die beste Anrufumgebung in HoloLens nutzen Sie Dynamics 365 Guides.

Über Guides können dieselben Remote-Experten Sie bei einem Problem unterstützen, während der holografische Inhalt einer Anleitung vor Ihnen erscheint.

Erfahren Sie mehr und probieren Sie Guides aus!

Hinweis

Azure Active Directory ist jetzt Microsoft Entra ID. Weitere Informationen

Sie können Code in Ihre HoloLens-, iOS- oder Android-Anwendung einbetten, um zu Microsoft Dynamics 365 Remote Assist zu wechseln und einen Anruf mit einem Uniform Resource Identifier (URI) zu starten.

Angenommen, Sie erstellen eine App zur Wartung eines Helikopters. Sie können eine Schaltfläche hinzufügen, über die ein Wartungstechniker einen Experten anrufen kann, wenn er nicht weiterkommt. Über die Schaltfläche wird Dynamics 365 Remote Assist gestartet und der gewünschte Experte angerufen.

Protokollaktivierung für HoloLens

Die Dynamics 365 Remote Assist-Anwendung für HoloLens unterstützt zwei Methoden zur Protokollaktivierung:

  • „ms-voip-video“ ist für videoaktivierte Anrufe.

  • „ms-voip-call“ ist für Nur-Audio-Anrufe.

Beide Methoden verwenden das gleiche Argumentschema, das ein contactID-Feld akzeptiert. Der URI sieht in etwa folgendermaßen aus:

ms-voip-video:?contactids=\<contactID\>

Die Kontakt-ID ist die Objekt-ID Microsoft Entra des Benutzers.

Code-Beispiel

Sie müssen den Code in Ihre App HoloLens integrieren. Das folgende Codebeispiel wird in C++ geschrieben, kann jedoch einfach in eine andere Sprache konvertiert werden.

Platform::String\^ id = objectId-\>Text;
auto uri = ref new Windows::Foundation::Uri("ms-voip-video:?contactids=" + id);
resultText-\>Text = uri-\>AbsoluteUri; 

concurrency::task\<bool\> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
launchUriOperation.then([this](bool success)   
{         
    if (success)         
    {             
        // URI launched  
        resultText-\>Text += " (URI Launched)"; 
    } 
    else         
    {             
        // URI launch failed             
        resultText-\>Text += " (FAILED)";
    }     
});

Verwenden Sie den URI „ms-voip-call:?contactids=“, um einen Audio- anstelle eines Videoanrufs zu tätigen.

Am Ende des Anrufs zur Ihrer App zurückkehren

Sie können das zusätzliche Feld returnto hinzufügen, damit Dynamics 365 Remote Assist am Ende des Anrufs zu Ihrer Anwendung zurückkehrt. So können Benutzer die Erfahrung in Ihrer App starten und beenden, ohne manuell zwischen Apps wechseln zu müssen.

Zur Unterstützung des Felds returnto müssen Sie Ihre App mit einem benutzerdefinierten URI registrieren (siehe Registrieren einer App mit einem benutzerdefinierten URI).

Fügen Sie dann das optionale Feld returnto zusammen mit dem registrierten App-Namen ein, dessen Registrierung Sie im vorherigen Schritt abgeschlossen haben. Im folgenden Beispiel lautet der registrierte URI „helicoptor-maintenance-app“:

ms-voip-call:?contactids=<CONTACT_ID>&returnto=helicoptor-maintenance-app");

Beispiel für das Starten von Dynamics 365 Remote Assist über Ihre App mit dem optionalen Feld „returnto“

Das folgende Codebeispiel wird in C++ geschrieben, kann jedoch einfach in eine andere Sprache konvertiert werden.

Platform::String^ id = objectId->Text;
auto uri = ref new Windows::Foundation::Uri("ms-voip-video:?contactids=" + id + &returnto=helicoptor-maintenance-app");
resultText->Text = uri->AbsoluteUri; 

concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
launchUriOperation.then([this](bool success)   
{         
    if (success)         
    {             
        // URI launched  
        resultText->Text += " (URI Launched)"; 
    } 
    else         
    {             
        // URI launch failed             
        resultText->Text += " (FAILED)";
    }     
});

Tätigen Sie einen Anruf, um Ihren Code zu testen.

  1. Führen Sie Ihre App auf dem HoloLens aus.

  2. Beginnen Sie den Anruf mit Ihrer App.

  3. HoloLens wird zum Schließen der App angezeigt. Öffnen Sie Dynamics 365 Remote Assist, wenn sie nicht bereits geöffnet ist, und melden Sie sich an.

  4. Wenn der Kontaktbereich geladen ist, ruft Dynamics 365 Remote Assist den angegebenen Kontakt an.

Weitere Informationen zum Starten einer App mit einem URI finden Sie unter Starten einer App mit einem URI.

Protokollaktivierung für iOS und Android

Die mobile Dynamics 365 Remote Assist-App unterstützt zwei Methoden zur Protokollaktivierung:

  • Wenn bekannt ist, dass die mobile Remote Assist-App bereits auf dem Gerät installiert ist, wird „ramobile“ verwendet.
  • Wenn nicht bekannt ist, ob die mobil Remote Assist-App bereits auf dem Gerät installiert ist, wird „https://call.d365ra.com/link"“ verwendet.

Das Argumentschema für beide Methoden akzeptiert das optionale Feld contactSearch, bei dem es sich um eine Zeichenfolgenreihe im JSON-Format handelt, mit der ein Kontakt gesucht werden kann.

    { "contactSearch":[ "supportContact@microsoft.com"] }

Beispiel

In diesem Beispiel führen wir eine Kontaktsuche durch. Wir müssen den Parameter contactSearch einbeziehen, bei dem es sich um eine Reihe von Suchzeichenfolgen handelt.

  1. Zuerst bilden wir eine JSON-Zeichenfolge:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Codieren Sie die JSON-Zeichenfolge in Base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Zur Verwendung der „ramobile:“-Methode hängen Sie die Base64-codierte Zeichenfolge an „ramobile:“ an, um den neuen URI zu bilden. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Wird dieser Link ausgewählt, wird die mobile Remote Assist-App gestartet, sucht nach den angegebenen Kontaktdaten und liefert dem Benutzer Ergebnisse.

3b. Hängen Sie zur Verwendung der HTTPS-Deeplink-Methode die Base64-codierte Zeichenfolge als Wert an den Schlüssel „d“ an. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Wenn dieser Link ausgewählt wird und die mobile Remote Assist-App nicht installiert ist, wird ein Webbrowser geöffnet, in dem der Benutzer zur Installation der mobilen Remote Assist-App aufgefordert wird. Nach der Installation kann der Benutzer auf eine andere Schaltfläche klicken, um die mobile Remote Assist-App zu starten, nach den angegebenen Kontaktdaten zu suchen und dem Benutzer Ergebnisse bereitzustellen. Wenn die mobile Remote Assist-App bereits installiert ist, wird sie gestartet, sucht nach den angegebenen Kontaktdaten und liefert dem Benutzer Ergebnisse.