從另一個應用程式啟動 Dynamics 365 Remote Assist (通訊協定啟用)

文章
04/30/2024

提示

Dynamics 365 Remote Assist 客戶現在可以在 Microsoft Teams 行動裝置中存取 Remote Assist。利用 Teams 提供的所有功能，與其他使用者共同作業！為了在 HoloLens 上獲得最佳通話體驗，請使用 Dynamics 365 Guides。

借助 Guides，當您面前出現指南的全像投影內容時，相同的遠端專家可以幫助您解決問題。

深入了解並試用 Guides！

注意

Azure Active Directory 現在改為 Microsoft Entra ID。深入了解。

您可以在您的 HoloLens、iOS 或 Android 應用程式中內嵌程式碼，以切換到 Microsoft Dynamics 365 Remote Assist，並使用統一資源識別項 (URI) 開始通話。

例如，假設您正在建立一個直升機維護應用程式。您可以新增一個按鈕，維護工程師可以使用該按鈕在遇到問題時致電專家。該按鈕將啟動 Dynamics 365 Remote Assist 並致電指定專家。

HoloLens 通訊協定啟用

Dynamics 365 Remote Assist HoloLens 應用程式支援兩種通訊協定啟用方法：

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

撥打電話以測試您的程式碼

在 HoloLens 上執行您的應用程式。
從您的應用程式啟始通話。
HoloLens 會看似關閉應用程式，開啟 Dynamics 365 Remote Assist (如果尚未開啟)，然後登入。
連絡人面板載入後，Dynamics 365 Remote Assist 將撥打電話給指定的連絡人。

如需使用 URI 啟動應用程式的詳細資訊，請參閱使用 URI 啟動應用程式。

iOS 和 Android 通訊協定啟用

Dynamics 365 Remote Assist 行動應用程式支援兩種通訊協定啟用方法：

已知 Remote Assist Mobile 將安裝於使用中裝置時，將會使用 “ramobile”。
如果不確定 Remote Assist Mobile 是否將安裝於使用中裝置時，將會使用「https://call.d365ra.com/link"」。

兩種方法的引數結構描述都可接受選擇性 contactSearch 欄位，這是用於尋找連絡人的 JSON 格式字串陣列。

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

範例

在這個範例中，我們將執行連絡人搜尋。我們需要包括 contactSearch 參數，即搜尋字符陣列。

首先要形成一個 JSON 字串：

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

編碼處理 base64 的 JSON 字串。 ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. 若要使用 "ramobile:" 方法，請將 base64 編碼的字串附加到 "ramobile:"，接著產生新的 URI。 "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

選擇此連結後，Remote Assist Mobile 將啟動並搜尋所提供的連絡人詳細資料，接著將結果提供給使用者。

3b. 若要使用 https 深層連結方法，請將 base64 編碼的字串當做值附加至 'd' 金鑰。 "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

如果選擇此連結時並未安裝 Remote Assist Mobile，此時 Web 瀏覽器將會開啟，提示使用者安裝 Remote Assist Mobile。安裝之後，使用者可以按一下另一個按鈕以啟動 Remote Assist Mobile，並搜尋所提供的連絡人詳細資料，接著將結果提供給使用者。如果此時已安裝 Remote Assist Mobile，則 Remote Assist Mobile 將啟動並搜尋所提供的連絡人詳細資料，接著將結果提供給使用者。