เปิดใช้ Dynamics 365 Remote Assist จากแอปอื่น (การเปิดใช้งานโปรโตคอล)

  • บทความ

คำแนะนำ

ขณะนี้ลูกค้า Dynamics 365 Remote Assist สามารถเข้าถึง Remote Assist ใน Microsoft Teams สำหรับอุปกรณ์เคลื่อนที่ได้แล้ว ใช้ประโยชน์จากข้อมูลทั้งหมดที่ Teams มีให้และ ร่วมมือกับผู้ใช้รายอื่น เพื่อประสบการณ์การโทรที่ดีที่สุดบน HoloLens ให้ใช้ Dynamics 365 Guides

ด้วย Guides ผู้เชี่ยวชาญทางไกลคนเดิมจะสามารถช่วยเหลือคุณผ่านปัญหาได้ในขณะที่คุณมีเนื้อหาแบบโฮโลแกรมของคู่มือปรากฏต่อหน้าคุณ

เรียนรู้เพิ่มเติม แล้ว ลองใช้ Guides

หมายเหตุ

Azure Active Directory ตอนนี้เป็น Microsoft Entra ID เรียนรู้เพิ่มเติม

คุณสามารถฝังโค้ดในแอปพลิเคชัน HoloLens, iOS หรือ Android เพื่อสลับไปใช้ Microsoft Dynamics 365 Remote Assist และเริ่มต้นการโทรโดยใช้ Uniform Resource Identifier (URI)

ตัวอย่างเช่น สมมติว่าคุณสร้างแอปเพื่อการบำรุงรักษาเฮลิคอปเตอร์ คุณสามารถเพิ่มปุ่มที่วิศวกรฝ่ายบํารุงรักษาสามารถใช้เพื่อโทรหาผู้เชี่ยวชาญได้ถ้าเกิดข้อขัดข้องขึ้น ปุ่มนี้จะเปิดใช้งาน Dynamics 365 Remote Assist และโทรหาผู้เชี่ยวชาญที่ได้รับมอบหมาย

การเปิดใช้งานโปรโตคอล HoloLens

แอปพลิเคชัน Dynamics 365 Remote Assist HoloLens รองรับวิธีการเปิดใช้งานโปรโตคอลสองวิธีด้วยกัน ดังนี้

  • "ms-voip-video" ใช้สำหรับการโทรผ่านวิดีโอ

  • "ms-voip-call" ใช้สำหรับการโทรด้วยเสียงเท่านั้น

ทั้งสองวิธีใช้ Schema อาร์กิวเมนต์เดียวกัน ซึ่งยอมรับฟิลด์ "contactID" URI อาจมีลักษณะบางอย่างดังนี้

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

ID ผู้ติดต่อคือ ID ออบเจ็กต์ Microsoft Entra ของผู้ใช้

ตัวอย่างโค้ด

คุณจะต้องฝังโค้ดในแอป 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");

ตัวอย่างของการเริ่มใช้งาน Dynamics 365 Remote Assist จากแอปของคุณด้วยฟิลด์ returnto ที่เพิ่มเติม

ตัวอย่างโค้ดต่อไปนี้ถูกเขียนขึ้นด้วยภาษา 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 สำหรับอุปกรณ์เคลื่อนที่จะรองรับวิธีการเปิดใช้งานโปรโตคอลสองวิธีด้วยกัน ดังนี้

  • "ramobile" จะถูกใช้เมื่อทราบว่ามีการติดตั้ง Remote Assist สำหรับอุปกรณ์เคลื่อนที่บนอุปกรณ์แล้ว
  • "https://call.d365ra.com/link" จะถูกใช้หาก Remote Assist สำหรับอุปกรณ์เคลื่อนที่ไม่ได้รับการยืนยันว่าติดตั้งบนอุปกรณ์แล้ว

Schema อาร์กิวเมนต์ของทั้งสองวิธีการยอมรับฟิลด์ contactSearch เสริม ซึ่งเป็นอาร์เรย์ของสตริงที่อยู่ในรูปแบบ JSON ที่จะใช้ในการค้นหาผู้ติดต่อ

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

ตัวอย่างเช่น

จากตัวอย่างนี้ เราจะทำการค้นหาผู้ติดต่อ เราต้องรวมพารามิเตอร์ contactSearch ซึ่งเป็นอาร์เรย์ของสตริงการค้นหา

  1. อันดับแรก เราต้องสร้างสตริง JSON:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. เข้ารหัสสตริง JSON ใน Base64 ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. หากต้องการใช้วิธีการ "ramobile:" ให้ทำการผนวกสตริงที่เข้ารหัส Base64 เข้ากับ "ramobile:" เพื่อทำให้เกิด URI ใหม่ "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

เมื่อเลือกลิงก์นี้ Remote Assist สำหรับอุปกรณ์เคลื่อนที่จะเริ่มต้นทำงานและค้นหารายละเอียดผู้ติดต่อที่ระบุและให้ผลลัพธ์แก่ผู้ใช้

3b. หากต้องการใช้วิธีการดีปลิงก์ https ให้ทำการผนวกสตริงที่เข้ารหัส Base64 เป็นค่าเข้ากับคีย์ 'd' "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

เมื่อเลือกลิงก์นี้และไม่มีการติดตั้ง Remote Assist สำหรับอุปกรณ์เคลื่อนที่เว็บเบราเซอร์จะเปิดขึ้นมา เพื่อเตือนผู้ใช้ให้ติดตั้ง Remote Assist สำหรับอุปกรณ์เคลื่อนที่ เมื่อติดตั้งแล้ว ผู้ใช้สามารถคลิกปุ่มอื่นเพื่อเริ่มต้นใช้ Remote Assist สำหรับอุปกรณ์เคลื่อนที่ได้ แล้วค้นหารายละเอียดผู้ติดต่อที่ระบุและให้ผลลัพธ์แก่ผู้ใช้ หากมีการติดตั้ง Remote Assist สำหรับอุปกรณ์เคลื่อนที่ไว้แล้ว Remote Assist สำหรับอุปกรณ์เคลื่อนที่จะเริ่มต้นทำงานและค้นหารายละเอียดผู้ติดต่อที่ระบุและให้ผลลัพธ์แก่ผู้ใช้