Стартиране на 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 и да започнете обаждане с помощта на еднозначен идентификатор на ресурс (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 от вашето приложение с незадължително поле 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 Mobile поддържа два метода за активиране на протокол:

  • „ramobile“ се използва, когато е известно, че мобилното приложение Remote Assist вече е инсталирано на устройството.
  • „https://call.d365ra.com/link"“ се използва, ако не е потвърдено, че мобилното приложение Remote Assist вече е инсталирано на устройството.

Схемата за аргументите и за двата метода приема незадължително поле 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 ще се стартира и ще търси въведените данни за контакт и ще предостави резултати на потребителя.

3б. За да използвате метода за дълбока връзка https, добавете кодирания в Base64 низ като стойност към ключа „d“. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Когато тази връзка е избрана и мобилното приложение Remote Assist не е инсталирано, ще се отвори уеб браузър с подкана към потребителя да инсталира мобилното приложение Remote Assist. След инсталирането потребителят може да щракне върху друг бутон, за да се стартира мобилното приложение Remote Assist и да потърси въведените данни за контакт и да предостави резултатите на потребителя. Ако мобилното приложение Remote Assist вече е инсталирано, мобилното приложение Remote Assist ще се стартира и ще търси въведените данни за контакт и ще предостави резултати на потребителя.