Lancer Dynamics 365 Remote Assist à partir d’une autre application (activation de protocole)

  • Article

Conseil

Saviez-vous que vous pouvez accéder à de meilleures expériences d’appel avec Dynamics 365 Guides ?

À l’aide des Guides, vous pouvez rejoindre n’importe quelle réunion Teams, consulter votre calendrier complet, accéder à tous vos fichiers importants, annoter, etc.

Avec les Guides, les mêmes experts à distance peuvent vous aider à résoudre un problème pendant que le contenu holographique d’un guide apparaît devant vous.

Apprenez-en plus et essayez Guides.

Remarque

Azure Active Directory est désormais Microsoft Entra ID. En savoir plus.

Vous pouvez incorporer du code dans votre application HoloLens, iOS ou Android pour basculer vers Microsoft Dynamics 365 Remote Assist et commencer un appel à l’aide d’un Uniform Resource Identifier (URI).

Par exemple, supposons que vous créez une application pour la maintenance d’hélicoptères. Vous pouvez ajouter un bouton qu’un ingénieur de maintenance pourra utiliser pour appeler un expert s’il est bloqué. Ce bouton lancera Dynamics 365 Remote Assist et appellera l’expert désigné.

Activation du protocole HoloLens

L’application Dynamics 365 Remote Assist HoloLens prend en charge deux méthodes pour l’activation du protocole :

  • “ms-voip-video” concerne l’appel vidéo.

  • “ms-voip-call” concerne l’appel audio.

Ces deux méthodes utilisent le même schéma d’argument qui accepte un champ « contactID ». L’URI ressemblerait à ceci :

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

L’ID contact est l’ID objet Microsoft Entra de l’utilisateur.

Exemple de code

Vous devez incorporer le code dans votre application HoloLens. L’exemple de code suivant est écrit en C++, mais peut être facilement adapté à un autre langage.

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

Pour passer un appel audio uniquement au lieu de vidéo, utilisez l’URI : “ms-voip-call:?contactids=”

Revenir à votre application à la fin d’un appel

Un champ supplémentaire returnto peut être inclus pour que Dynamics 365 Remote Assist puisse revenir à votre application à la fin d’un appel. Les utilisateurs peuvent ainsi commencer et mettre fin à leur expérience dans votre application sans avoir à basculer manuellement de l’une à l’autre.

Pour prendre en charge le champ returnto, vous devez enregistrer votre application avec un URI personnalisé (voir Enregistrer une application avec un URI personnalisé).

Ajoutez ensuite le champ facultatif returnto ainsi que le nom de l’application enregistrée que vous avez renseigné à l’étape précédente. Dans l’exemple ci-dessous, « helicoptor-maintenance-app » est l’URI enregistré :

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

Exemple de lancement de Dynamics 365 Remote Assist à partir de votre application avec le champ facultatif « returnto »

L’exemple de code suivant est écrit en C++, mais peut être facilement adapté à un autre langage.

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

Passer un appel pour tester votre code

  1. Exécutez votre application sur l’HoloLens.

  2. Initialisez l’appel depuis votre application.

  3. L’HoloLens s’affiche pour fermer l’application, ouvrez Dynamics 365 Remote Assist s’il n’est pas déjà ouvert et connectez-vous.

  4. Une fois le panneau de contacts chargé, Dynamics 365 Remote Assist passe un appel au contact spécifié.

Pour plus d’informations sur le lancement d’une application avec un URI, consultez Lancer une application avec un URI.

Activation de protocole iOS et Android

L’application mobile Dynamics 365 Remote Assist prend en charge deux méthodes pour l’activation du protocole :

  • "ramobile" est utilisé lorsque Remote Assist Mobile est déjà installé sur l’appareil.
  • https://call.d365ra.com/link" est utilisé lorsque Remote Assist Mobile n’est pas encore installé sur l’appareil.

Le schéma d’argument des deux méthodes accepte un champ contactSearch facultatif, qui est un tableau de chaînes au format JSON à utiliser pour rechercher un contact.

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

Exemple

Pour cet exemple, nous allons effectuer une recherche de contact. Nous devons inclure le paramètre contactSearch, qui est un tableau de chaînes de recherche.

  1. Nous formons d’abord une chaîne JSON :
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Encodez la chaîne JSON en base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Pour utiliser la méthode « ramobile : », ajoutez la chaîne encodée en base64 à « ramobile : » à partir du nouvel URI. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Lorsque ce lien est sélectionné, Remote Assist Mobile se lance et recherche les coordonnées fournies et fournit les résultats à l’utilisateur.

3b. Pour utiliser la méthode deeplink https, ajoutez la chaîne encodée en base64 comme valeur à la clé « d ». "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Lorsque ce lien est sélectionné et si Remote Assist Mobile n’est pas installé, un navigateur Web s’ouvre et invite l’utilisateur à installer Remote Assist Mobile. Une fois installé, l’utilisateur peut cliquer sur un autre bouton pour lancer Remote Assist Mobile et rechercher les coordonnées fournies et fournir des résultats à l’utilisateur. Si Remote Assist Mobile est déjà installé, Remote Assist Mobile se lance et recherche les coordonnées fournies et fournit les résultats à l’utilisateur.