„Dynamics 365 Remote Assist“ paleidimas iš kitos programos (protokolo aktyvinimas)

  • Straipsnis

Patarimas

„Dynamics 365 Remote Assist“ klientai nuo šiol turi prieigą prie „Remote Assist“ mobiliųjų įrenginių programėlėje „Microsoft Teams“. Išnaudokite visas „Teams“ galimybes ir bendradarbiaukite su kitais vartotojais! Kad skambučių su „HoloLens“ patirtis būtų kuo geresnė, naudokite „Dynamics 365 Guides“.

Naudojant „Guides“, tie patys nuotoliniai ekspertai gali padėti išspręsti problemą, kol jums rodomas holografinis „Guide“ turinys.

Sužinokite daugiau ir išbandykite „Guides“!

Pastaba

„Azure Active Directory“ tapo „Microsoft Entra ID“. Sužinokite daugiau.

Norėdami perjungti į „Microsoft Dynamics 365 Remote Assist“ ir pradėti skambutį naudodami vieningąjį identifikatorių (URI), galite įdėti kodą savo „HoloLens“, „iOS“ arba „Android“ programoje.

Pavyzdžiui, tarkime, kad kuriate sraigtasparnio priežiūros programą. Galite pridėti mygtuką, kurį priežiūros inžinierius galės naudoti norėdamas paskambinti specialistui, jei pačiam nepavyks išspręsti problemos. Mygtukas atidarys „Dynamics 365 Remote Assist“ ir paskambins nurodytam ekspertui.

„HoloLens“ protokolo aktyvinimas

Programa „Dynamics 365 Remote Assist HoloLens“ palaiko du protokolo aktyvinimo metodus:

  • „ms-voip-video“ skirtas skambučiui su vaizdu;

  • „ms-voip-call“ skirtas tik garso skambučiui.

Abu metodai naudoja tą pačią argumentų schemą, kuri priima lauką „contactID“. URI atrodys maždaug taip:

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

Kontakto ID yra vartotojo „Microsoft Entra“ objekto ID.

Kodo pavyzdys

Jums reikės įdėti kodą savo „HoloLens“ programoje. Toliau pateiktas kodo pavyzdys parašytas C++ kalba, tačiau gali būti lengvai pritaikomas kitai kalbai.

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

Norėdami vietoj vaizdo skambučio atlikti tik garso skambutį, naudokite URI: „ms-voip-call:?contactids=“

Skambučio pabaigoje grįžkite į programą

Galima įtraukti papildomą returnto lauką, kad skambučiui pasibaigus „Dynamics 365 Remote Assist“ grįžtų į jūsų programą. Taip vartotojai gali ir pradėti, ir baigti naudojimąsi jūsų programa, neperjungdami programų rankiniu būdu.

Norėdami palaikyti returnto lauką, turite užregistruoti savo programą pasirinktiniu URI (žr. Programos registravimas naudojant pasirinktinį URI).

Tada įtraukite pasirinktinį returnto lauką kartu su ankstesniame veiksme užregistruotos programos pavadinimu. Toliau pateiktame pavyzdyje užregistruotas URI yra „helicoptor-maintenance-app“:

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

„Dynamics 365 Remote Assist“ paleidimo iš programos, naudojant pasirinktinį „returnto“ lauką, pavyzdys

Toliau pateiktas kodo pavyzdys parašytas C++ kalba, tačiau gali būti lengvai pritaikomas kitai kalbai.

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

Skambinimas, norint patikrinti kodą

  1. Paleiskite savo programą „HoloLens“.

  2. Inicijuokite skambutį iš savo programos.

  3. Bus rodoma „HoloLens“, kad galėtumėte uždaryti programą, atidaryti „Dynamics 365 Remote Assist“, jei dar nėra atidaryta, ir prisijungti.

  4. Įkėlus kontaktų skydą, „Dynamics 365 Remote Assist“ skambins nurodytam kontaktui.

Daugiau informacijos apie programos paleidimą naudojant URI žr. Programos paleidimas naudojant URI.

„iOS“ ir „Android“ protokolo aktyvinimas

„Dynamics 365 Remote Assist“ mobiliųjų įrenginių programėlė palaiko du protokolo aktyvinimo metodus:

  • „ramobile“ naudojamas, kai yra žinoma, kad „Remote Assist Mobile“ jau įdiegta įrenginyje;
  • „https://call.d365ra.com/link"“ naudojamas, jei nėra patvirtinta, kad „Remote Assist Mobile“ jau įdiegta įrenginyje.

Abiejų metodų argumentų schema priima pasirinktinį lauką contactSearch, kuris yra JSON formato eilučių masyvas, naudojamas ieškant kontakto.

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

Pavyzdys

Šiame pavyzdyje atliksime kontakto iešką. Turime įtraukti parametrą contactSearch, kuris yra paieškos eilučių masyvas.

  1. Pirmiausia sudarome JSON eilutę:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. JSON eilutė koduojama „base64“ formatu. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Norint naudoti metodą „ramobile:“, prie „ramobile:“ pridedama „base64“ formatu užkoduota eilutė, kad būtų sudarytas naujas URI. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kai pasirinktas šis saitas, bus paleista „Remote Assist Mobile“, kuri ieškos pateiktos kontakto informacijos ir pateiks vartotojui rezultatus.

3b. Norint naudoti https giliojo saito metodą, prie rakto „d“ kaip reikšmė pridedama „base64“ formatu užkoduota eilutė. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kai pasirenkamas šis saitas, o „Remote Assist Mobile“ nėra įdiegta, bus atidaryta žiniatinklio naršyklė, raginanti vartotoją įdiegti „Remote Assist Mobile“. Įdiegus, vartotojas gali spustelėti kitą mygtuką, kad paleistų „Remote Assist Mobile“, kuri ieškos pateiktos kontakto informacijos ir pateiks vartotojui rezultatus. Jei „Remote Assist Mobile“ jau įdiegta, jis bus paleista ir ieškos pateiktos kontakto informacijos bei pateiks vartotojui rezultatus.