Start Dynamics 365 Remote Assist fra en annen app (protokollaktivering)

Du kan bygge inn kode i HoloLens, iOS- eller Android-appen for å bytte til Microsoft Dynamics 365 Remote Assist og begynne en samtale ved hjelp av en Uniform Resource Identifier (URI).

La oss for eksempel si at du oppretter en vedlikeholdsapp for helikopter. Du kan legge til en knapp som en vedlikeholdstekniker kan bruke til å ringe en ekspert hvis de blir sittende fast. Knappen starter Dynamics 365 Remote Assist og ringer den utpekte eksperter.

HoloLens-protokollaktivering

Dynamics 365 Remote Assist HoloLens-programmet støtter to metoder for protokollaktivering:

• ms-voip-video er for videoaktivert anrop.

• ms-voip-call er for bare lydanrop.

Begge metodene bruker samme argumentsskjema, som godtar et contactID-felt. URI-en vil se omtrent slik ut:

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

Kontakt-ID-en er brukerens objekt-ID for Azure Active Directory (Azure AD).

Kodeeksempel

Du må bygge inn koden i HoloLens-appen. Følgende kodeeksempel er skrevet på C++, men kan lett tilpasses til annet språk.

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

Hvis du vil foreta et anrop med bare lyd i stedet for video, bruker du URI: “ms-voip-call:?contactids=”

Gå tilbake til appen på slutten av en samtale

Du kan legge ved et ekstra returnto-felt for å få Dynamics 365 Remote Assist til å gå tilbake til programmet når en samtale slutter. Dette gjør at brukere både kan starte og avslutte opplevelsen i appen uten å måtte bytte manuelt mellom dem.

For å støtte returnto-feltet må du registrere appen med en egendefinert URI (se Registrer en app med en egendefinert URI).

Inkluder deretter det valgfrie returnto-feltet sammen med det registrerte appnavnet du fullførte i forrige trinn. I eksempelet nedenfor er helicoptor-maintenance-app den registrerte URI-en:

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

Eksempel på å starte Dynamics 365 Remote Assist fra appen med valgfritt returnto-felt

Følgende kodeeksempel er skrevet på C++, men kan lett tilpasses til annet språk.

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

Ring for å teste koden

1. Kjør appen på HoloLens.

2. Start samtalen fra appen.

3. HoloLens vises for å lukke appen, åpnes Dynamics 365 Remote Assist hvis den ikke allerede er åpen og logg deg på.

4. Når kontaktpanelet er lastet inn, ringer Dynamics 365 Remote Assist den angitte kontakten.

Hvis du vil ha mer informasjon om å starte en app med en URI, kan du se Start en app med en URI.

iOS- og Android-protokollaktivering

Dynamics 365 Remote Assist-mobilappen støtter de to protokollaktiveringsmåtene:

• ramobile brukes når Remote Assist Mobile allerede er installert på enheten.
• https://call.d365ra.com/link.html brukes hvis Remote Assist Mobile ikke er bekreftet som installert på enheten.

Argumentsskjemaet for begge metodene godtar et valgfritt contactSearch-felt, som er en JSON-formatert matrise med strenger som skal brukes til å finne en kontakt.

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

Eksempel

I dette eksemplet utfører vi et kontaktsøk. Vi må ta med contactSearch-parameteren, som er en matrise med søkestrenger.

1. Først danner vi en JSON-streng:

    {
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }

2. Kod JSON-strengen i base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Hvis du vil bruke ramobile:-metoden, legger du til den base64-kodede strengen til ramobile: fra den nye URI-en. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Når denne koblingen er valgt, starter Remote Assist Mobile og søker etter de angitte kontaktdetaljene og gir resultater til brukeren.

3b. Hvis du vil bruke metoden for https-dypkobling, legger du til den base64-kodede strengen som en verdi i d-nøkkelen. "https://call.d365ra.com/link.html?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Når denne koblingen er valgt, og Remote Assist Mobile ikke er installert, åpnes en nettleser, og brukeren blir bedt om å installere Remote Assist Mobile. Når den er installert, kan brukeren klikke på en annen knapp for å starte Remote Assist Mobile og søke etter kontaktdetaljene som er angitt, og gi resultater til brukeren. Hvis Remote Assist Mobile allerede er installert, starter Remote Assist Mobile og søker etter de angitte kontaktdetaljene og gir resultater til brukeren.

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).