تشغيل Dynamics 365 Remote Assist من تطبيق آخر (تنشيط البروتوكول)

  • مقالة

التلميح

هل تعلم أنه يمكنك الوصول إلى تجربة الاتصال الأفضل باستخدام Dynamics 365 Guides؟

باستخدام Guides، يمكنك الانضمام إلى أي اجتماع في Teams، ومراجعة التقويم الخاص بك بالكامل، والوصول إلى كل الملفات المهمة وإضافة تعليقات وغير ذلك.

باستخدام 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\>

معرف جهة الاتصال هو معرف كائن 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 من تطبيقك باستخدام حقل الإرجاع الاختياري

مثال التعليمات البرمجية التالي مكتوب بلغة ++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 Mobile مثبت على الجهاز بالفعل.
  • "https://call.d365ra.com/link""؛ يُستخدم في حالة عدم تأكيد تثبيت Remote Assist Mobile على الجهاز بالفعل.

يقبل مخطط الوسيطة لكلتا الطريقتين حقلاً contactSearch اختياريًا، وهو عبارة عن مصفوفة من السلاسل بتنسيق JSON لاستخدامها في العثور على جهة اتصال.

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

مثال

بالنسبة لهذا المثال، سنقوم بإجراء بحث عن جهة الاتصال. يجب تضمين معلمة contactSearch، وهي عبارة عن صفيف من سلاسل البحث.

  1. أولاً نكوّن سلسلة JSON:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. قم بترميز سلسلة JSON في base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3أ. لاستخدام طريقة "ramobile:"، قم بإلحاق سلسلة base64 المرمزة بـ "ramobile:" لتكوين عنوان URI الجديد. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

عند تحديد هذا الارتباط، سيتم تشغيل Remote Assist Mobile والبحث عن تفاصيل الاتصال المقدمة وتقديم النتائج للمستخدم.

3ب. لاستخدام طريقة https للرابط الداخلي، قم بإلحاق سلسلة base64 المرمزة كقيمة بالمفتاح "d". "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

عند تحديد هذا الارتباط وعدم تثبيت Remote Assist Mobile، سيفتح مستعرض ويب، ويطالب المستخدم بتثبيت Remote Assist Mobile. بمجرد التثبيت، يمكن للمستخدم النقر فوق زر آخر لتشغيل Remote Assist Mobile والبحث عن تفاصيل الاتصال المقدمة وتقديم النتائج للمستخدم. إذا تم تثبيت Remote Assist Mobile بالفعل، فسيتم تشغيل Remote Assist Mobile ويبحث عن تفاصيل الاتصال المقدمة ويقدم النتائج للمستخدم.