Käynnistä Dynamics 365 Remote Assist toisesta sovelluksesta (protokollan aktivointi)

  • Artikkeli

Vinkki

Tiesitkö, että Dynamics 365 Guidesin avulla puhelukokemukset ovat entistäkin parempia?

Guidesin avulla voit esimerkiksi liittyä mihin tahansa Teams-kokoukseen, nähdä koko kalenterin, käyttää kaikkia tärkeitä tiedostojasi ja lisätä huomautuksia.

Guidesissa samat etäasiantuntijat voivat auttaa selvittämään ongelman silloin, kun Guidesin hologrammisisältö on edessäsi.

Opi lisää ja kokeile Guidesia!

Huomautus

Azure Active Directory on nyt Microsoft Entra ID. Lisätietoja.

Voit upottaa koodin HoloLens-, iOS- tai Android-sovellukseen, kun haluat siirtyä Microsoft Dynamics 365 Remote Assistiin ja aloittaa puhelun URI-osoitteen (Uniform Resource Identifier) avulla.

Oletetaan esimerkiksi, että olet kehittämässä sovellusta helikopterin huoltoon. Voit lisätä painikkeen, jonka avulla huoltoinsinööri voi soittaa asiantuntijalle, jos huollossa ilmenee ongelmia. Painike käynnistää Dynamics 365 Remote Assistin ja soittaa määritetylle asiantuntijalle.

HoloLens – protokollan aktivointi

Dynamics 365 Remote Assist HoloLens -sovellus tukee kahta protokollan aktivointimenetelmää:

  • ”ms-voip-video” on tarkoitettu videopuheluihin.

  • ”ms-voip-call” on vain äänipuhelua varten.

Molemmissa menetelmissä käytetään samaa argumenttiskeemaa, joka hyväksyy contactID-kentän. URI voisi näyttää seuraavalta:

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

Yhteyshenkilön tunnus on käyttäjän Microsoft Entra ‑objektitunnus.

Koodiesimerkki

Koodi on upotettava HoloLens-sovellukseen. Seuraava koodiesimerkki on kirjoitettu C++ -kielellä, mutta se voidaan helposti mukauttaa toiseen kieleen.

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

Jos haluat soittaa vain äänipuhelun videopuhelun sijaan, käytä URI-osoitetta ”ms-voip-call:?contactids=”

Sovellukseen palaaminen puhelun lopussa

Voit sisällyttää returnto-lisäkentän, jos haluat Dynamics 365 Remote Assistin palaavan sovellukseesi puhelun päätyttyä. Näin käyttäjät voivat sekä aloittaa että lopettaa käyttökokemuksen sovelluksessasi, eikä heidän tarvitse vaihtaa manuaalisesti sovellusten välillä.

Jos haluat tukea returnto-kenttää, sinun on rekisteröitävä sovelluksesi mukautetulla URI-osoitteella (katso Sovelluksen rekisteröiminen mukautetulla URI-osoitteella).

Lisää sitten valinnainen returnto-kenttä sekä edellisestä vaiheesta saatu rekisteröity sovelluksen nimi. Alla olevassa esimerkissä rekisteröity URI on ”helicopter-maintenance-app”:

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

Esimerkki Dynamics 365 Remote Assist -sovelluksen käynnistämisestä käyttäen valinnaista returnto-kenttää

Seuraava koodiesimerkki on kirjoitettu C++ -kielellä, mutta se voidaan helposti mukauttaa toiseen kieleen.

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

Testaa koodisi soittamalla puhelu

  1. Suorita sovelluksesi HoloLensissa.

  2. Aloita puhelu sovelluksestasi.

  3. HoloLens tulee näkyviin sovelluksen sulkemista varten, avaa Dynamics 365 Remote Assist, jos se ei ole vielä avoinna, ja kirjaudu sisään.

  4. Kun yhteyshenkilöpaneeli on ladattu, Dynamics 365 Remote Assist soittaa puhelun määritetylle yhteyshenkilölle.

Lisätietoja sovelluksen käynnistämisestä URI-osoitteen avulla on kohdassa Sovelluksen käynnistäminen URI-osoitteen avulla.

iOS ja Android – protokollan aktivointi

Dynamics 365 Remote Assist -mobiilisovellus tukee kahta protokollan aktivointimenetelmää:

  • ”ramobile” – tätä käytetään, kun tiedetään, että Remote Assist -mobiilisovellus on jo asennettuna laitteeseen.
  • ”https://call.d365ra.com/link"” – tätä käytetään, kun Remote Assist -mobiilisovelluksen asennusta laitteeseen ei voi vahvistaa.

Molempien menetelmien argumenttiskeema hyväksyy valinnaisen contactSearch-kentän, joka on yhteyshenkilöhaussa käytettävä JSON-muotoinen merkkijonotaulukko.

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

Esimerkki

Tässä esimerkissä suoritetaan yhteyshenkilön haku. Tähän sisällytetään contactSearch-parametri, joka on hakumerkkijonojen taulukko.

  1. Ensin muodostetaan JSON-merkkijono:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Koodaa JSON-merkkijono base64-muodossa. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Jos haluat käyttää ”ramobile”-menetelmää, lisää base64-koodattu merkkijono ”ramobile”-merkkijonoon uuden URI-osoitteen muodostamiseksi. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kun tämä linkki on valittu, Remote Assist -mobiilisovellus käynnistyy, etsii annetut yhteystiedot ja näyttää tulokset käyttäjälle.

3b. Jos haluat käyttää https-syvälinkkiä, lisää base64-koodattu merkkijono arvona ”d”-avaimeen. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kun tämä linkki on valittu eikä Remote Assist -mobiilisovellus ole asennettuna, näyttöön avautuu verkkoselain, jossa käyttäjää pyydetään asentamaan Remote Assist -mobiilisovellus. Kun sovellus on asennettu, käyttäjä voi käynnistää Remote Assist -mobiilisovelluksen toisella painikkeella, etsiä annettuja yhteystietoja ja selata tuloksia. Jos Remote Assist -mobiilisovellus on jo asennettu, se käynnistyy, etsii annetut yhteystiedot ja näyttää tulokset käyttäjälle.