Iniciar o Dynamics 365 Remote Assist de outro aplicativo (ativação de protocolo)

  • Artigo

Dica

Os clientes do Dynamics 365 Remote Assist agora têm acesso ao Remote Assist no Microsoft Teams para dispositivos móveis. Aproveite tudo o que o Teams tem a oferecer e colabore com outros usuários. Para a melhor experiência de chamada no HoloLens, use o Dynamics 365 Guides.

Com o Guides, os mesmos especialistas remotos podem ajudá-lo durante um problema enquanto o conteúdo holográfico de um guia que aparece para você.

Saiba mais e experimente o Guides!

Observação

O Azure Active Directory agora é o Microsoft Entra ID. Saiba mais.

Você pode inserir o código em seu aplicativo do HoloLens, iOS ou Android para alternar para o Microsoft Dynamics 365 Remote Assist e iniciar uma chamada usando um URI (Uniform Resource Identifier).

Por exemplo, suponha que você esteja criando um aplicativo de manutenção Helicopter. Você pode adicionar um botão que um engenheiro de manutenção possa usar para chamar um especialista se ele ficar preso. O botão será ativado Dynamics 365 Remote Assist e chamará o especialista designado.

Ativação de protocolo para o HoloLens

O aplicativo oferece suporte a dois métodos de ativação de protocolo para o Dynamics 365 Remote Assist HoloLens:

  • O "ms-voip-video" é para habilitação de chamada de vídeo.

  • O "ms-voip-call" destina-se somente à chamada de áudio.

Os dois métodos usam o mesmo esquema de argumento, que aceita um campo "ContactID". O URI deve ser algo assim:

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

A ID do contato é a ID do objeto do usuário do Microsoft Entra.

Exemplo de código

Você precisará inserir o código no seu aplicativo do HoloLens. O exemplo de código a seguir é escrito em C++, mas pode ser adaptado facilmente 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 colocar uma chamada somente de áudio em vez de vídeo, use URI: "ms-voip-call:? contactids ="

Retorne ao aplicativo no final de uma chamada

Um campo adicional returnto pode ser incluído para que o Dynamics 365 Remote Assist retorne ao aplicativo quando uma chamada termina. Isso permite que os usuários iniciem e concluam sua experiência no seu aplicativo sem precisar alternar manualmente entre eles.

Para dar suporte ao campo returnto, você precisa registrar seu aplicativo com um URI personalizado (consulte registrar um aplicativo com um URIpersonalizado).

Em seguida, inclua o campo opcional returnto juntamente ao nome do aplicativo registrado que você concluiu na etapa anterior. No exemplo a seguir, "aplicativo de manutenção Helicoptor" é o URI registrado:

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

Exemplo de inicialização do Dynamics 365 Remote Assist a partir do aplicativo com o campo "returnto" opcional

O exemplo de código a seguir é escrito em C++, mas pode ser adaptado facilmente 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 seu código

  1. Execute seu aplicativo no HoloLens.

  2. Inicie a chamada de seu aplicativo.

  3. O HoloLens aparentemente fechará o aplicativo, abra o aplicativo Dynamics 365 Remote Assist se ainda não estiver aberto e insira suas credenciais.

  4. Depois que o painel de contatos for carregado, Dynamics 365 Remote Assist ele exibirá uma chamada para o contato especificado.

Para obter mais informações sobre como iniciar um aplicativo com um URI, consulte Iniciar um aplicativo com um URI.

Ativação de protocolo no iOS e no Android

O aplicativo móvel do Dynamics 365 Remote Assist oferece suporte a dois métodos de ativação de protocolo:

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

O esquema de argumentos para os dois métodos aceita um campo opcional contactSearch, que é uma matriz formatada por JSON de cadeias de caracteres a ser usada para localizar um contato.

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

Exemplo

Para este exemplo, executaremos uma pesquisa de contato. Precisamos incluir o parâmetro contactSearch, que é uma matriz de sequências de caracteres de pesquisa.

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

3a. Para usar o método "ramobile:", acrescente a sequência codificada na base64 a "ramobile:" para formar o novo URI. "ramobile:ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Quando este link estiver selecionado, o Remote Assist para dispositivos móveis será iniciado e procurará os detalhes do contato fornecido e exibirá os resultados ao usuário.

3b. Para usar o método HTTPS de link direto, acrescente a sequência codificada na Base64 como um valor à chave "d". "https://call.d365ra.com/link?d=ewogICJjb250YWN0U2VhcmNoIjpbCiAgICAiSmlsbCBTbWl0aCIsCiAgICAiamlsbHNtaXRoQG1pY3Jvc29mdC5leGFtcGxlIgogIF0KfQo=";

Quando este link é selecionado e o Remote Assist para dispositivos móveis não está instalado, um navegador da Web é aberto, solicitando ao usuário a instalação do Remote Assist para dispositivos móveis. Depois de instalado, o usuário poderá clicar em outro botão para iniciar o Remote Assist para dispositivos móveis e procurar os detalhes de contato fornecidos e oferecer resultados ao usuário. Se o Remote Assist para dispositivos móveis já estiver instalado, o Remote Assist para dispositivos móveis será iniciado e procurará os detalhes do contato fornecido e exibirá os resultados ao usuário.