Gravação de vídeo

Introdução

A gravação de vídeo da tela é realizada com o VideoRecording Component.

Este componente é responsável por capturar a tela do dispositivo em segundo plano. Ele é voltado principalmente para a gravação do processo de Onboarding.

---

Dependência

A dependência específica do componente é:

implementation "com.facephi.androidsdk:video_recording_component:$version"

---

Controladores disponíveis

Controlador	Descrição
FVideoRecordingController	Controlador principal de Gravação de Vídeo.
FStopVideoRecordingController	Controlador para realizar a parada da Gravação de Vídeo.

Recepção de erros

Os erros serão retornados como um objeto 'VideoRecordingError'.

Lista de erros:

Lista de erros de Gravação de Vídeo:

• VRC_CANCEL_BY_USER: O usuário cancelou o processo

• VRC_COMPONENT_LICENSE_ERROR: A licença do componente não está correta

• VRC_EMPTY_LICENSE: A String de licença está vazia

• VRC_INITIALIZATION_ERROR: Erro de Inicialização

• VRC_OPERATION_NOT_CREATED: Não há nenhuma operação em andamento

• VRC_NETWORK_CONNECTION: Erro na conexão com a internet

• VRC_PERMISSION_ERROR: O usuário rejeitou as permissões necessárias. Com enableAudio=true também cobre a negação ou o fechamento da permissão de microfone e a rejeição da permissão de MediaProjection.

• VRC_SOCKET_ERROR: Erro na conexão dos serviços

• VRC_UNKNOWN_ERROR: Erro desconhecido

• VRC_VIDEO_CALL_ACTIVE: Não é possível iniciar porque há uma Videochamada ativa

• VRC_VIDEO_ERROR: Erro no processamento do vídeo

• VRC_VIDEO_RECORDING_ACTIVE: Não é possível iniciar porque o processo de Gravação de Vídeo está ativo

• VRC_FETCH_DATA_ERROR: Erro na coleta do resultado

Configuração avançada

O controlador utiliza VideoRecordingConfigurationData para configurar a conexão com o serviço de vídeo e o comportamento da gravação:

• url: Caminho para o socket de vídeo. Normalmente é obtido da licença, exceto em ambientes OnPremise.

• apiKey: Chave necessária para a conexão com o socket de vídeo.

• tenantId: Identificador do tenant do cliente.

• enableAudio: Ativa a captura de áudio durante a gravação de tela. Por padrão false. Se for informado como true, o Android solicita RECORD_AUDIO antes da permissão de MediaProjection; se o usuário negar ou fechar a permissão, o componente retorna VRC_PERMISSION_ERROR.

Recebimento do resultado correto - data

Em caso de sucesso, data contém um VideoRecordingResult.

• state: Estado da gravação. SHARING indica que a gravação fica iniciada e FINISH indica que foi interrompida corretamente.