別のアプリから Dynamics 365 Remote Assist を起動する (プロトコルの有効化)

  • [アーティクル]

ヒント

Dynamics 365 Remote Assist の顧客は Microsoft Teams モバイルで Remote Assist にアクセスできます。 Teams で利用できる機能をすべて活用し、他のユーザーとコラボレーションしましょう! HoloLens で最高の通話エクスペリエンスを実現するためには、Dynamics 365 Guides を使用してください。

Guides では、ガイドのホログラフィック コンテンツを目の前に表示しながら、同じリモート エキスパートに問題の解決を支援してもらうことができます。

詳細を確認して Guides をお試しください!

メモ

現在 Azure Active Directory は Microsoft Entra ID になりました。 詳細情報。

Uniform Resource Identifier (URI) を使用して HoloLens、iOS、または Android アプリケーションにコードを埋め込み、Microsoft Dynamics 365 Remote Assist に切り替えて通話を開始できます。

たとえば、ヘリコプターのメンテナンス アプリを作成しているとします。 メンテナンス エンジニアが作業に行き詰まった場合に、エキスパートに電話をかけるためのボタンを追加することができます。 このボタンが Dynamics 365 Remote Assist を起動し、指定されたエキスパートに電話をかけます。

HoloLens プロトコルのアクティブ化

Dynamics 365 Remote Assist HoloLens アプリケーションは、次の 2 つのプロトコル アクティブ化方法をサポートしています。

  • 「ms-voip-video」はビデオ対応の通話を対象としています。

  • 「ms-voip-call」は音声のみの通話を対象としています。

どちらの方法も同じ引数のスキーマを使用しており、このスキーマは「contactID」フィールドを受け入れます。 次に URI の例を示します。

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

連絡先 ID とは、ユーザーの Microsoft Entra オブジェクト ID です。

コードの例

HoloLens アプリにコードを埋め込む必要があります。 次に示すコードの例は C++ で記述されていますが、別の言語にも簡単に応用できます。

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

ビデオ通話ではなく、音声のみの電話をかけるには、URI「ms-voip-call:?contactids=」を使用します。

通話が終了するとアプリに戻ります。

追加の returnto フィールドを含めると、通話の終了後に Dynamics 365 Remote Assist をアプリケーションに戻すことができます。 これでユーザーは手動で切り替えることなくアプリのエクスペリエンスを開始および終了できます。

returnto フィールドをサポートするには、カスタム URI にアプリを登録する必要があります (カスタム URI にアプリを登録を参照してください)。

次に、前の手順で入力した登録済みアプリの名前とともに、オプションで returnto フィールドを含めます。 以下の例で「helicoptor-maintenance-app」は登録済み URI です。

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

オプションで returnto フィールドを使用してアプリから Dynamics 365 Remote Assist を起動する例

次に示すコードの例は C++ で記述されていますが、別の言語にも簡単に応用できます。

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

電話をかけてコードをテストする

  1. アプリを HoloLens で実行します。

  2. アプリから呼び出しを開始します。

  3. HoloLens が表示され、アプリが終了します。Dynamics 365 Remote Assist をまだ開いていない場合は開いてサインインします。

  4. 連絡先パネルが読み込まれると、Dynamics 365 Remote Assist によって、指定された連絡先に電話がかけられます。

URI によるアプリの起動の詳細については、「URI を使ったアプリの起動」を参照してください。

iOS および Android プロトコルのアクティブ化

Dynamics 365 Remote Assist モバイル アプリケーションは、次の 2 つのプロトコル アクティブ化方法をサポートしています。

  • "ramobile" は、Remote Assist モバイルがデバイスに既にインストールされていることがわかっている場合に使用します。
  • "https://call.d365ra.com/link" は、Remote Assist モバイルをデバイスにインストール済みであるかどうか定かでない場合に使用します。

両方の方法の引数スキーマは、オプションの contactSearch フィールドを受け入れます。これは、連絡先の検索に使用する文字列の JSON 形式の配列です。

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

例

この例では、連絡先の検索を実行します。 検索文字列の配列である、contactSearch パラメーターを含める必要があります。

  1. まず、JSON 文字列を形成します。
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. BASE64 で JSON 文字列をエンコードします。 ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. "ramobile:" メソッドを使用するには、base64 でエンコードされた文字列を "ramobile:" に追加して新しい URI を形成します。 "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

このリンクが選択されている場合、Remote Assist モバイルが起動し、提供された連絡先の詳細が検索されて、結果がユーザーに表示されます。

3b. https ディープ リンク メソッドを使用するには、base64 でエンコードされた文字列を 'd' キーの値として追加します。 "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

このリンクが選択されており、Remote Assist モバイルがインストールされていない場合は、Web ブラウザーが開き、Remote Assist モバイルをインストールするように求めるメッセージがユーザーに表示されます。 インストール後、ユーザーは別のボタンをクリックして Remote Assist モバイルを起動し、指定された連絡先の詳細を検索して結果をユーザーに提供できます。 Remote Assist モバイルが既にインストールされている場合は、Remote Assist モバイルが起動し、提供された連絡先の詳細が検索されて、結果がユーザーに表示されます。