Base de Conhecimento

Pré-requisitos

• iOS 15.4 e superior
• Uma conta existente TeamViewer

Se você não possui uma conta TeamViewer, siga os passos aqui para criar uma.

Instale o SDK do TeamViewer para dispositivos móveis.

Você pode instalar o SDK do TeamViewer com o Swift Package Manager (SPM) ou manualmente, seguindo os passos abaixo:

O método connectToSessionCode retorna uma sessão TeamViewer.

IMPORTANTE:

• Você é responsável por manter esta variável viva, e também responsável por liberá-la. Caso contrário, a sessão UI poderá ser mantida viva mesmo depois que a sessão remota tiver terminado.
• Uma vez que o SDK se conecta a um código de sessão, ele entra em estado de espera, você é notificado sobre a mudança de estado por meio do método de delegado handleSessionCodeOnline.

Neste ponto, não se deve permitir que o usuário se conecte a um código de sessão diferente. Só é permitido permitir que o usuário deixe a conexão atual.

No lado do apoiador, o código de sessão aparecerá como estando online, permitindo ao cliente estabelecer uma conexão com esse código de sessão.

Reagindo às conexões de entrada

O SDK fornece métodos de delegados para reagir a eventos de conexão de entrada.

Uma vez iniciada a conexão no lado TeamViewer, o SDK é notificado sobre esta tentativa de conexão através do método de delegado handleConnectionRequestWithAuthenticationData.

No parâmetro de dados de autenticação há o nome do apoiador, o tipo de conexão de entrada (ScreenShare ou Assist AR) e uma função de retorno de chamada para permitir ou rejeitar a conexão de entrada.

Se a conexão de entrada for aceita, a conexão TeamViewer correspondente é estabelecida.

• Para a conexão ScreenShare, um prompt para microfone e compartilhamento de tela é mostrado ao usuário.

A IU de sua aplicação é agarrada usando o kit de replay e há comunicação VoIP bidirecional entre o usuário e o apoiador.

• Para a conexão Assist AR, são mostradas as permissões do sistema para acesso de câmera e microfone. Se o usuário permitir isto, a sessão de AR é iniciada. Há comunicação VoIP bi-direcional entre o usuário e o apoiador.
• O método de delegação handleConnectionRequestAbort deve ser implementado a fim de ser notificado quando o usuário remoto cancela o pedido de conexão. O usuário é responsável por limpar quaisquer avisos que sejam mostrados ao usuário, ou cancelar quaisquer notificações de chamadas recebidas do CallKit.

Reagindo a eventos opcionais SDK

• handleSupporterConnected: Este método é chamado quando o apoiador abre a sessão, também é chamado quando o usuário abre localmente a sessão.
• handleSupporterDisconnected: Este método é chamado quando o apoiador terminou a sessão, também é chamado quando o usuário terminou localmente a sessão.

Dica: Você deve limpar as referências à sessão, pois a sessão é considerada não mais válida neste momento.

• handleError: Este método é chamado se o código de sessão ou o token API utilizado para estabelecer uma conexão não for válido.

Dica: Você deve limpar os recursos utilizados para a sessão atual, pois a sessão em si é considerada inválida.

Reagindo a eventos opcionais da sessão

• handleSessionError: Isto é chamado quando ocorre um erro durante a sessão. Por exemplo, um recurso foi solicitado, mas a compatibilidade entre cliente e servidor não foi atendida.

Dica: Este erro é apenas informativo. Você pode escrevê-lo em um arquivo de log.

Nota sobre o suporte do CallKit

Se sua aplicação suporta o CallKit:

• Forneça ao TeamViewer SDK informações sobre o identificador exclusivo de sua chamada.
• TeamViewer pergunta ao sistema se há uma chamada em execução e não tenta estabelecer uma conexão VoIP se for este o caso.
• Diga a TeamViewer que a chamada atual é sua para que possamos assumir a tubulação de áudio e iniciar a transmissão VoIP:
  1. Ligue para o método de configuração setupCallUUID.
  2. Diga ao SDK que sua chamada terminou chamando o método clearCallUUID.

Ative os modelos em segundo plano

Certifique-se de que você tenha pelo menos um desses modos de fundo ativado em seu arquivo Info.plist:

• Áudio,
• AirPlay ou
• Modo de fundo Voice over IP.