Skip to main content

Base de Conhecimento

Back to support overview

SDK móvel para iOS

Last Modified 21 de jan. de 2026

Com TeamViewer Software Development Kit (SDK) você pode utilizar a funcionalidade completa Assist AR e fornecer a melhor experiência de suporte remoto AR a seus clientes, incorporando as capacidades de assistência remota AR em seus próprios aplicativos móveis.

O SDK permite que você tenha conexões seguras e compatíveis com a GDPR com os dispositivos de seu cliente.

Este artigo se aplica a todos os usuários do TeamViewer Assist AR.

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.

Gerar uma chave API

1. Abra e logue com sua conta no TeamViewer Remote ou https://web.teamviewer.com/.

2. Clique em Configurações de administração.

3. Em Autenticação, clique em Apps e Tokens.

4. Clique em Configurações de perfil.

5. Clique no menu suspenso Criar app ou token e clique em Criar SDK móvel.

6. Insira um nome e uma descrição (opcional).

7. No sistema Mobile SDK, selecione iOS.

8. Clique em Salvar.

O token SDK para dispositivos móveis é exibido ao abrir a seção Apps e Tokens:

9. Clique nos três pontos, clique em Copiar token e cole-o em um local seguro.

IMPORTANTE: Não compartilhe este token com ninguém.

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:

Configurando seu projeto Xcode

O SDK do TeamViewer utiliza a câmera e o microfone durante uma sessão de suporte remoto.

Adicione as seguintes chaves ao arquivo Info.Plist:

  • Descrição de uso do NSMicrophone
  • Descrição de uso da câmera NS

Se você não adicionar essas chaves, o iOS encerrará a aplicação no momento em que o SDK tentar acessar o microfone ou a câmera.

Usando o SDK do TeamViewer

IMPORTANTE

  • O SDK é uma classe de instância única. Você não pode criar uma instância diretamente. Em vez disso, acesse a instância compartilhada.
  • Mudança interruptiva para integrações Swift na versão 15.81
    • A principal classe cliente do SDK, TeamViewerSDK, foi renomeada para TeamViewerSDKClient.
    • O código Objective-C que usa o nome antigo continua compilando e executando sem alterações.
    • O código Swift deve ser atualizado para fazer referência a TeamViewerSDKClient.
    • O acessador singleton sharedSDK e todos os outros métodos permanecem inalterados.
// Antes
let tvSDK: TeamViewerSDK = .sharedSDK()
// Depois
let tvSDK: TeamViewerSDKClient = .sharedSDK()

 

Conectar e gerenciar sessões

 

1. Inicialize a instância do SDK com sua chave de API obtida na seção Pré-requisitos.

private func setupSDK() {
   let token = "YOUR_TOKEN_HERE"
   let tvSDK: TeamViewerSDKClient = .sharedSDK()
   self.tvSDK.setup(with: token,
                    andDelegate: self)
 }

2. Defina um delegado em conformidade com o protocolo TeamViewerSDKDelegate.

Isto garante que consegue reagir a eventos que ocorrem durante o tempo de vida da sua ligação TeamViewer.

3. Ligar a um código de sessão

O SDK partilhado disponibiliza um método para estabelecer uma ligação a um código de sessão. Este código de sessão pode ser de dois tipos:

  • Remote Support ou
  • Assist AR

4. Crie códigos de sessão no seu cliente TeamViewer ou através da API REST do TeamViewer.

self.session = tvSDK.connect(toSessionCode: code)

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.

IMPORTANTE: Se isso não for feito, o aplicativo será suspenso apenas alguns segundos após ser colocado em segundo plano durante uma sessão ativa TeamViewer.

Configuração de áudio

O SDK móvel funciona com os valores de configuração padrão da AVAudioSession.

  • Se você quiser sobrepor estes valores para suportar Bluetooth, Airplay mix, usar alto-falantes, etc., certifique-se de mudar isto antes de uma sessão ser estabelecida. No caso de sua aplicação silenciar outras aplicações, o momento recomendado para configurar a sessão de áudio é bem antes de aceitar a conexão.
  • Se sua aplicação mixar áudio com outras aplicações, você pode configurar as opções de áudio no lançamento da aplicação.

Desativar VoIP

Caso você queira usar outro meio para estabelecer comunicação de voz, você pode desativar o recurso VoIP inteiramente definindo as opções na instância compartilhada do SDK antes de estabelecer uma conexão.

Para mais informações, consulte a documentação TVSDKOptions.

Documentação de classe

Todos os cabeçalhos públicos estão documentados. Para obter informações detalhadas sobre cada classe, consulte o conteúdo QuickHelp gerado pelo Xcode ("⌥"+ clique no nome constante ou variável).