Басқа бағдарламадан Dynamics 365 Remote Assist қызметін іске қосу (протоколды белсендіру)

Кеңес

Dynamics 365 Guides көмегімен жақсырақ қоңырау шалу тәжірибесіне қол жеткізе алатыныңызды білесіз бе?

Guides пайдалана отырып, кез келген Teams жиналысына қосылуға, толық күнтізбеңізді көруге, барлық маңызды файлыңызға қол жеткізуге, аннотациялар жасауға және т.б. болады.

Guide голографиялық мазмұны алдыңызда пайда болған кезде, Guides көмегімен бірдей қашықтағы сарапшылар мәселе бойынша көмектесе алады.

Қосымша ақпарат және Guides-ты қолданып көру!

Ескертпе

Қазір Azure Active Directory — Microsoft Entra ID. Қосымша ақпарат.

Microsoft Dynamics 365 Remote Assist қызметіне ауысу үшін HoloLens, iOS немесе Android бағдарламасында кодты ендіріп, Бірыңғай ресурс идентификаторымен (URI) қоңырауды бастауға болады.

Мысалы, сіз тікұшаққа техникалық қызмет көрсету бағдарламасын жасап жатырсыз делік. Техникалық қызмет көрсету инженері кептеліп қалса, сарапшыға қоңырау шалу үшін пайдалануға болатын түймені қосуға болады. Түйме Dynamics 365 Remote Assist қызметін іске қосады және тағайындалған сарапшыға қоңырау шалады.

HoloLens протоколын белсендіру

Dynamics 365 Remote Assist HoloLens бағдарламасында протоколды белсендірудің екі әдісіне қолдау көрсетіледі:

  • "ms-voip-video" бейне қосулы қоңырау шалуға арналған.

  • "ms-voip-call" тек аудио қоңырауға арналған.

Екі әдісте де "контакт идентификаторы" өрісін қабылдайтын бірдей аргумент схемасы пайдаланылады. 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="

Қоңыраудың соңында бағдарламаға оралу

Қоңырау аяқталған кезде Dynamics 365 Remote Assist қызметін бағдарламаңызға қайтару үшін қосымша returnto өрісін қосуға болады. Бұл пайдаланушылардың арасында қолмен ауыстырмай-ақ бағдарламаңыздағы тәжірибесін бастауына және аяқтауына мүмкіндік береді.

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 мобильді құрылғы бағдарламасында екі протоколды белсендіру әдісіне қолдау көрсетіледі:

  • Құрылғыда Remote Assist Mobile бағдарламасы орнатылып қойылғаны белгілі болған кезде, "ramobile" пайдаланылады.
  • Құрылғыда Remote Assist Mobile бағдарламасы орнатылып қойылғаны расталмаса, "https://call.d365ra.com/link" пайдаланылады.

Екі әдіс үшін де аргумент схемасы қосымша contactSearch өрісін қабылдайды, ол — контактіні табу үшін пайдаланылатын жолдардың JSON пішімделген массиві.

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

Мысал

Бұл мысал үшін контактілерді іздейміз. Іздеу жолдарының массиві болып табылатын contactSearch параметрін қосуымыз керек.

  1. Алдымен JSON жолын пішіндеңіз:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. JSON жолын base64 пішімінде кодтаңыз. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. "ramobile:" әдісін пайдалану үшін, жаңа URI идентификаторын пішіндеу мақсатында base64 кодталған жолын "ramobile:" параметріне қосыңыз. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Бұл сілтеме таңдалған кезде, Remote Assist Mobile іске қосылады, берілген байланыс мәліметтерін іздейді және пайдаланушыға нәтижелерді береді.

3b. 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 іске қосылады, берілген байланыс мәліметтерін іздейді және пайдаланушыға нәтижелерді береді.