Iniciar o Dynamics 365 Remote Assist a partir de outra aplicação (ativação de protocolos)

  • Artigo

Sugestão

Sabia que pode aceder a melhores experiências de chamadas com o Dynamics 365 Guides?

Com o Guides, pode participar em qualquer reunião do Teams, ver o seu calendário completo, aceder todos os seus ficheiros importantes, anotar e muito mais.

Com o Guides, os mesmos especialistas remotos podem ajudar a resolver um problema enquanto o conteúdo holográfico de um Guia é apresentado à sua frente.

Saiba mais e experimente o Guides!

Nota

O Azure Active Directory é agora Microsoft Entra ID. Saber mais.

Pode incorporar código na sua aplicação HoloLens, iOS ou Android para mudar para o Microsoft Dynamics 365 Remote Assist e iniciar uma chamada utilizando um URI (Uniform Resource Identifier).

Por exemplo, imaginemos que está a criar uma aplicação de manutenção de helicópteros. Pode adicionar um botão que um engenheiro de manutenção pode usar para chamar um especialista se ele ficar preso. O botão irá iniciar o Dynamics 365 Remote Assist e chamar o especialista designado.

Ativação do Protocolo HoloLens

A aplicação Dynamics 365 Remote Assist HoloLens suporta dois métodos para ativação de protocolos:

  • "ms-voip-video" destina-se a chamadas ativadas para vídeo.

  • "ms-voip-call" destina-se apenas a chamadas de áudio.

Ambos os métodos utilizam o mesmo esquema de argumento, que aceita um campo "contactID". O URI teria o seguinte aspeto:

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

O ID do contacto é o ID do objeto do Microsoft Entra do utilizador.

Exemplo de código

Terá de incorporar o código na sua aplicação HoloLens. O exemplo de código seguinte está escrito em C++, mas pode ser facilmente adaptado para outra linguagem.

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)";
    }     
});

Para fazer uma chamada apenas de áudio em vez de vídeo, utilize URI: "ms-voip-call:?contactids="

Voltar para a sua aplicação no final de uma chamada

É possível incluir um campo returnto adicional para fazer o Dynamics 365 Remote Assist voltar para a sua aplicação quando uma chamada terminar. Isto permite que os utilizadores iniciem e terminem a respetiva experiência na sua aplicação sem terem de alternar manualmente entre eles.

Para suportar o campo returnto, tem de registar a sua aplicação com um URI personalizado (consulte Registar uma aplicação com um URI personalizado).

Em seguida, inclua o campo returnto opcional juntamente com o nome da aplicação registada que preencheu no passo anterior. No exemplo abaixo, "aplicação-manutenção-helicópteros" é o URI registado:

ms-voip-call:?contactids=<CONTACT_ID>&returnto=helicoptor-maintenance-app");

Exemplo de início do Dynamics 365 Remote Assist a partir da sua aplicação com campo returnto opcional

O exemplo de código seguinte está escrito em C++, mas pode ser facilmente adaptado para outra linguagem.

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)";
    }     
});

Faça uma chamada para testar o seu código

  1. Execute a sua aplicação na HoloLens.

  2. Inicie a chamada a partir da sua aplicação.

  3. O HoloLens irá aparecer para fechar a aplicação, abrir o Dynamics 365 Remote Assist se ainda não estiver aberto e iniciar sessão.

  4. Depois de o painel de contactos ser carregado, o Dynamics 365 Remote Assist irá fazer uma chamada para o contacto especificado.

Para obter mais informações sobre o início de uma aplicação com um URI, consulte Iniciar uma aplicação com um URI.

Ativação dos protocolos iOS e Android

A aplicação móvel Dynamics 365 Remote Assist suporta os dois métodos de ativação de protocolos:

  • "ramobile" é utilizado quando o Remote Assist para dispositivos móveis já está instalado no dispositivo.
  • "https://call.d365ra.com/link" é utilizado se a instalação do Remote Assist para dispositivos móveis ainda não está confirmada no dispositivo.

O esquema de argumentos para ambos os métodos aceita um campo contactSearch opcional, o qual é uma matriz de cadeias de carateres com o formato JSON utilizada para encontrar um contacto.

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

Exemplo

Para este exemplo, realizaremos uma pesquisa de contactos. Temos de incluir o parâmetro contactSearch, que é uma matriz de cadeias de carateres de pesquisa.

  1. Primeiro, formamos uma cadeia de carateres JSON:
	{
      "contactSearch":[
        "Jill Smith",
        "jillsmith@microsoft.example"
      ]
    }
  1. Codifique a cadeia de carateres JSON em base64. ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=

3a. Para utilizar o método "ramobile:", acrescente a cadeia de carateres codificada em base64 a "ramobile:" para formar o novo URI. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Quando esta ligação é selecionada, o Remote Assist para dispositivos móveis será iniciado e pesquisará os detalhes do contacto fornecidos e fornecerá resultados ao utilizador.

3b. Para utilizar o método de ligação avançada https, acrescente a cadeia de carateres codificada em base64 como um valor à chave 'd'. "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Quando esta ligação é selecionada e o Remote Assist para dispositivos móveis não está instalado, é aberto um browser, solicitando que o utilizador instale o Remote Assist para dispositivos móveis. Depois de instalado, o utilizador pode clicar noutro botão para iniciar o Remote Assist para dispositivos móveis e procurar os detalhes de contacto fornecidos e fornecer resultados ao utilizador. Se o Remote Assist para dispositivos móveis já estiver instalado, será iniciado e pesquisará os detalhes do contacto fornecidos e fornecerá resultados ao utilizador.