Condividi tramite

Avviare Dynamics 365 Remote Assist da un'altra app (attivazione del protocollo)

Suggerimento

I clienti Dynamics 365 Remote Assist hanno ora accesso a Remote Assist in Microsoft Teams per dispositivi mobili. Altre informazioni: Collaborare con altri utenti e Utilizzare le annotazioni spaziali in Teams.

Nota

Azure Active Directory è ora Microsoft Entra ID. Altre informazioni.

È possibile incorporare il codice nell'applicazione HoloLens per passare a Microsoft Dynamics 365 Remote Assist e avviare una chiamata usando un URI (Uniform Resource Identifier).

Ad esempio, supponiamo che tu stia creando un'app di manutenzione per elicotteri. Puoi aggiungere un pulsante che un tecnico addetto alla manutenzione può usare per chiamare un esperto in caso di bisogno. Il pulsante avvia Dynamics 365 Remote Assist e chiama l'esperto designato.

Attivazione del protocollo HoloLens

L'applicazione Dynamics 365 Remote Assist HoloLens supporta due metodi per l'attivazione del protocollo:

  • "ms-voip-video" per le chiamate abilitate per il video.

  • "ms-voip-call" per le chiamate solo audio.

Entrambi i metodi usano lo stesso schema di argomenti, che accetta un campo "contactID". L'URI avrà un aspetto simile al seguente:

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

L'ID contatto è l'ID oggetto Microsoft Entra dell'utente.

Esempio di codice

Incorpora il codice nell'app HoloLens. L'esempio di codice seguente è scritto in C++, ma è facilmente adattabile a un altro linguaggio.

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

Per effettuare una chiamata solo audio invece che video, usa l'URI "ms-voip-call:?contactids="

Tornare all'app alla fine di una chiamata

Un altro campo returnto può essere aggiuntivo per fare in modo che Dynamics 365 Remote Assist torni all'applicazione alla fine di una chiamata. Questo campo consente agli utenti di iniziare e terminare l'esperienza nell'app senza dover passare manualmente tra l'app e la chiamata.

Per supportare il campo returnto è necessario registrare l'app con un URI personalizzato (vedi Registrare un'app con un URI personalizzato).

Includi quindi il campo facoltativo returnto con il nome dell'app registrata nel passaggio precedente. Nell'esempio seguente l'URI registrato è "helicoptor-maintenance-app":

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

Esempio di avvio di Dynamics 365 Remote Assist dall'app con il campo facoltativo returnto

L'esempio di codice seguente è scritto in C++, ma è facilmente adattabile a un altro linguaggio.

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

Effettuare una chiamata per testare il codice

  1. Esegui l'app in HoloLens.

  2. Avvia la chiamata dall'app.

  3. Viene visualizzato HoloLens per chiudere l'app, aprire Dynamics 365 Remote Assist, se non è già aperto, ed eseguire l'accesso.

  4. Dopo che il pannello dei contatti è stato caricato, Dynamics 365 Remote Assist avvierà una chiamata al contatto specificato.

Per altre informazioni sull'avvio di un app con un URI, vedi Avviare un'app con un URI.