הפעלת Dynamics 365 Remote Assist מתוך אפליקציה אחרת (הפעלת פרוטוקול)

עצה

ידעת ש- Dynamics 365 Guides מאפשרת לך חוויית שיחות טובה יותר?

באמצעות Guides, תוכל להצטרף לכל פגישת Teams, לראות את היומן המלא שלך, לגשת לכל הקבצים החשובים שלך, להוסיף ביאורים ועוד.

עם Guides, אותם מומחים מרחוק יוכלו לסייע לך לפתור בעיה בזמן שהתוכן ההולוגרפי של המדריך מופיע לפניך.

למידע נוסף ולהיכרות עם Guides!

הערה

Azure Active Directory הוא כעת מזהה Microsoft Entra. למידע נוסף.

ניתן להטמיע קוד באפליקציית 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 יחד עם שם האפליקציה הרשום שהשלמת בשלב הקודם. בדוגמה שלהלן, "helicopter-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 Mobile כבר מותקן במכשיר.
• "https://call.d365ra.com/link" משמשת כאשר לא ידוע אם Remote Assist Mobile כבר מותקן במכשיר.

סכימת הארגומנט עבור שתי השיטות מקבלת שדה contactSearch אופציונלי, שהוא מערך מחרוזות בפורמט JSON לשימוש עבור מציאת איש קשר.

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

דוגמה

בדוגמה זו, נבצע חיפוש אנשי קשר. עלינו לכלול את הפרמטר contactSearch, שהוא מערך של מחרוזות חיפוש.

1. ראשית ניצור מחרוזת JSON:

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

2. נקודד את מחרוזת ה- 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 יופעל, יחפש את פרטי הקשר שסופקו ויציג תוצאות למשתמש.