Dynamics 365 Remote Assist starten vanuit een andere app (protocolactivering)

  • Artikel

Tip

Dynamics 365 Remote Assist-klanten hebben nu toegang tot Remote Assist in de mobiele versie van Microsoft Teams. Haal uw voordeel uit alles wat Teams te bieden heeft en werk samen met andere gebruikers. Voor de beste belervaring op de HoloLens gebruikt u Dynamics 365 Guides.

Met Guides kunnen dezelfde externe experts u helpen een probleem te vinden terwijl de holografische inhoud van een guide voor u ligt.

Meer informatie en Guides proberen!

Opmerking

Azure Active Directory heet nu Microsoft Entra ID. Meer informatie.

U kunt code insluiten in uw HoloLens-, iOS- of Android-toepassing om over te schakelen naar Microsoft Dynamics 365 Remote Assist en een oproep starten met een URI (Uniform Resource Identifier).

Stel dat u bijvoorbeeld een app voor helikopteronderhoud maakt. U kunt een knop toevoegen die een onderhoudsmonteur kan gebruiken om een expert te bellen als hij of zij vastloopt. Met de knop wordt Dynamics 365 Remote Assist gestart en de aangewezen expert gebeld.

HoloLens Protocolactivering

De Dynamics 365 Remote Assist HoloLens-app ondersteunt twee methoden voor het activeren van protocollen:

  • “ms-voip-video” is bedoeld voor videogesprekken.

  • “ms-voip-call” is bedoeld voor audiogesprekken.

Bij beide methoden wordt hetzelfde argumentenschema gebruikt, dat een veld “contactID” accepteert. De URI kan er als volgt uitzien:

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

De contact-id is de object-id van Microsoft Entra van de gebruiker.

Voorbeeld van code

U moet de code insluiten in uw HoloLens-app. Het volgende codevoorbeeld is geschreven in C++, maar kan eenvoudig worden aangepast aan een andere taal.

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)";
    }     
});

Gebruik URI: “ms-voip-call:?contactids=” als u een gesprek met alleen audio wilt starten in plaats van video.

Aan het einde van een oproep teruggaan naar uw app

Een extra veld returnto kan worden opgenomen om Dynamics 365 Remote Assist terug te laten gaan naar de toepassing wanneer een oproep wordt beëindigd. Hierdoor kunnen gebruikers de bewerking in hun app starten en beëindigen zonder handmatig te hoeven schakelen.

Ter ondersteuning van het veld returnto moet u uw app registreren met een aangepaste URI (zie Een app registreren met een aangepaste URI).

Neem vervolgens het optionele veld returnto op samen met de naam van de geregistreerde app die u in de vorige stap hebt uitgevoerd. In het onderstaande voor beeld is "helicoptor-maintenance-app" de geregistreerde URI:

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

Voorbeeld van het starten van Dynamics 365 Remote Assist vanuit uw app met het optionele returnto-veld

Het volgende codevoorbeeld is geschreven in C++, maar kan eenvoudig worden aangepast aan een andere taal.

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)";
    }     
});

Start een gesprek om uw code te testen

  1. Voer uw app uit op de HoloLens.

  2. Start de oproep vanuit uw app.

  3. De HoloLens wordt weergegeven om de app te sluiten. Open Dynamics 365 Remote Assist als dat nog niet is geopend en meld u aan.

  4. Nadat het deelvenster met contactpersonen is geladen, start Dynamics 365 Remote Assist een oproep naar de opgegeven contactpersoon.

Zie Een app starten met een URI voor meer informatie over het starten van een app met een URI.

Verbeterde protocolactivering voor iOS en Android

De mobiele Dynamics 365 Remote Assist-app ondersteunt twee methoden voor het activeren van protocollen:

  • “ramobile” wordt gebruikt wanneer Remote Assist Mobile al geïnstalleerd is op het apparaat.
  • "https://call.d365ra.com/link" wordt gebruikt als de installatie van Remote Assist Mobile op het apparaat niet is bevestigd.

Voor het argumentschema voor beide methoden wordt een optioneel veld contactSearch geaccepteerd. Dit is een matrix met teken in JSON-indeling die u kunt gebruiken om een contactpersoon te zoeken.

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

Voorbeeld

Voor dit voorbeeld voeren we een actie Contact zoeken uit. We moeten de parameter contactSearch opnemen. Dit is een matrix van zoekreeksen.

  1. Eerst maken we een JSON-tekenreeks:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Versleutel de JSON-tekenreeks in base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Als u de methode "ramobile:" wilt gebruiken, moet u de versleutelde tekenreeks base64 toevoegen aan "ramobile" om de nieuwe URI te vormen. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Wanneer deze koppeling is geselecteerd, start Remote Assist Mobile, wordt er gezocht naar de geleverde contactgegevens en krijgt de gebruiker de resultaten te zien.

3b. Als u de https-dieptekoppelingsmethode wilt gebruiken, moet u de versleutelde tekenreeks base64 als een waarde toevoegen aan de sleutel 'd'. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Wanneer deze koppeling is geselecteerd en Remote Assist Mobile niet is geïnstalleerd, wordt er een webbrowser geopend waarin de gebruiker wordt gevraagd om Remote Assist Mobile te installeren. Zodra deze is geïnstalleerd, kan de gebruiker op een andere knop klikken om Remote Assist Mobile te starten en te zoeken naar de geleverde contactgegevens, zodat de resultaten zichtbaar worden. Als Remote Assist Mobile al is geïnstalleerd, start Remote Assist Mobile, wordt er gezocht naar de geleverde contactgegevens en krijgt de gebruiker de resultaten te zien.