Dynamics 365 Remote Assist palaišana no citas programmas (protokola aktivizēšana)

Padoms

Vai zinājāt, ka programma Dynamics 365 Guides var nodrošināt piekļuvi uzlabotai zvanīšanas pieredzei?

Izmantojot programmu Guides, varat pievienoties jebkurai Teams sapulcei, skatīt visu kalendāra saturu, piekļūt visiem svarīgajiem failiem, anotēt datus un veikt citas darbības.

Izmantojot programmu Guides, attālie eksperti var jums palīdzēt novērst problēmu, un vienlaikus varat skatīt ceļveža hologrāfisko saturu.

Uzziniet vairāk un izmēģiniet programmu Guides!

Piezīme

Azure Active Directory tagad ir Microsoft Entra ID. Papildinformācija.

Varat iegult kodu savā HoloLens, iOS vai Android programmā, lai pārslēgtos uz Microsoft Dynamics 365 Remote Assist un sāktu zvanu, izmantojot vienoto resursu identifikatoru (URI).

Piemēram, pieņemsim, ka veidojat helikopteru uzturēšanas programmu. Varat pievienot pogu, ko uzturēšanas inženieris var izmantot, lai izsauktu speciālistu, ja rodas problēma. Šī poga palaidīs Dynamics 365 Remote Assist un izsauks norādīto speciālistu.

HoloLens protokola aktivizēšana

Dynamics 365 Remote Assist HoloLens programma atbalsta divas protokola aktivizēšanas metodes:

  • “ms-voip-video” ir paredzēts videozvaniem.

  • “ms-voip-call” ir paredzēts tikai audiozvaniem.

Abas metodes izmanto to pašu argumenta shēmu, kas pieņem lauku “contactID”. URI izskatīsies šādi:

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

Kontaktpersonas ID ir lietotāja Microsoft Entra objekta ID.

Koda piemērs

Kods būs jāiegulst programmā HoloLens. Šis koda piemērs ir rakstīts C++, bet to var viegli pielāgot citai valodai.

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

Lai video vietā izmantotu tikai audiozvanu, izmantojiet URI: “ms-voip-call:?contactids=”

Atgriezties programmā pēc zvana beigām

Var iekļaut papildu lauku returnto, lai Dynamics 365 Remote Assist atgrieztos programmā pēc zvana pabeigšanas. Tādējādi lietotāji var gan sākt, gan beigt savu darbu jūsu programmā bez manuālas pārslēgšanās starp tām.

Lai atbalstītu lauku returnto, ir jāreģistrē programma ar pielāgotu URI (skatiet sadaļu Programmas reģistrēšana pielāgotā URI).

Pēc tam ietveriet izvēles lauku returnto kopā ar reģistrēto programmas nosaukumu, ko aizpildījāt iepriekšējā darbībā. Tālāk esošajā piemērā “helicoptor-maintenance-app” ir reģistrētais URI:

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

Piemērs Dynamics 365 Remote Assist palaišanai no programmas ar neobligātu lauku returnto

Šis koda piemērs ir rakstīts C++, bet to var viegli pielāgot citai valodai.

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

Veiciet zvanu, lai pārbaudītu savu kodu

  1. Palaidiet programmu datorā HoloLens.

  2. Sāciet zvanu no programmas.

  3. Izskatīsies, ka HoloLens aizver programmu; atveriet Dynamics 365 Remote Assist, ja tā vēl nav atvērta, un pierakstieties.

  4. Kad kontaktpersonu panelis tiks ielādēts, Dynamics 365 Remote Assist veiks zvanu norādītajai kontaktpersonai.

Papildinformāciju par programmas ar URI palaišanu skatiet sadaļā Programmas ar URI palaišana.

iOS un Android protokola aktivizēšana

Dynamics 365 Remote Assist mobilā programma atbalsta divas protokola aktivizēšanas metodes:

  • “ramobile” tiek lietots, kad ir zināms, ka programma Remote Assist Mobile jau ir instalēta ierīcē.
  • "https://call.d365ra.com/link" tiek lietots, ja netiek apstiprināts, ka programma Remote Assist Mobile jau ir instalēta ierīcē.

Argumenta shēma abām metodēm pieņem izvēles lauku contactSearch, kas ir JSON formatēts virkņu masīvs, ko izmantot kontaktpersonas atrašanai.

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

Piemērs

Šajā piemērā mēs veiksim kontaktpersonas meklēšanu. Ir jāietver parametrs contactSearch, kas ir meklēšanas virkņu masīvs.

  1. Vispirms izveidosim JSON virkni:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Kodējiet JSON virkni base64 formātā. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Lai izmantotu metodi “ramobile:”, pievienojiet base64 šifrēto virkni “ramobile:” jaunā URI izveidei. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kad šī saite ir atlasīta, programma Remote Assist Mobile palaidīs un meklēs norādīto kontaktinformāciju un dos rezultātus lietotājam.

3b. Lai izmantotu https dziļās saites metodi, pievienojiet base64 šifrēto virkni kā vērtību taustiņam “d”. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Kad šī saite ir atlasīta un programma Remote Assist Mobile nav instalēta, tīmekļa pārlūks atvērsies, aicinot lietotāju instalēt Remote Assist Mobile. Pēc instalēšanas lietotājs var klikšķināt uz citas pogas, lai palaistu Remote Assist Mobile un meklētu norādīto kontaktinformāciju un sniegtu lietotājam rezultātus. Ja programma Remote Assist Mobile jau ir instalēta, Remote Assist Mobile palaidīs un meklēs norādīto kontaktinformāciju un dos rezultātus lietotājam.