Videogravação - Videorecording

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. É 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
VideoRecordingController	Controlador principal de gravação de vídeo.
StopVideoRecordingController	Controlador para realizar a parada da gravação de vídeo.

---

---

Lançamento simplificado

Uma vez iniciado o SDK e criada uma nova operação, o componente poderá ser lançado. Será possível usar qualquer um de seus controladores para executar sua funcionalidade.

Lançamento da captura

Para iniciar a gravação de tela:

val response = SDKController.launch(
    VideoRecordingController(
        VideoRecordingConfigurationData(...)
    )
)

when (response) {
    is SdkResult.Error   -> Napier.d("ERROR - ${response.error.name}")
    is SdkResult.Success -> response.data
}

Parar a captura

Para parar a gravação de tela:

val controller = StopVideoRecordingController()

controller.setOutput {
    Napier.d("APP: VIDEO RECORDING STATE (stop): ${it.name}")
}

SDKController.launch(controller)

Recebimento de erros

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

Lista de erros:

• 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 abrange a negação ou fechamento da permissão de microfone e a recusa 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

Recebimento do resultado correto - data

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

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

Informações avançadas

Esta seção amplia as informações do componente.

Configuração avançada do componente

Para lançar o componente atual, será necessário criar um objeto VideoRecordingConfigurationData que será a configuração do controlador do componente.

A seguir, são detalhados todos os campos que fazem parte desta classe.

Os campos url, apiKey e tenantId normalmente não precisam ser informados pois são preenchidos internamente por meio da licença utilizada.

Esses campos costumam ser informados apenas quando o servidor é OnPremise.

url

Caminho para o socket de vídeo

apiKey

ApiKey necessária para a conexão com o socket de vídeo

tenantId

Identificador do tenant que faz referência ao cliente atual, necessário para a conexão com o serviço de vídeo.

enableAudio

Ativa a captura de áudio durante a gravação de tela. Por padrão false. Quando informado como true, o Android solicita RECORD_AUDIO antes da permissão de MediaProjection; se o usuário negar ou fechar a tela de permissões, é retornado VRC_PERMISSION_ERROR e a gravação não é iniciada.