Capturando vídeos

OzCapsula (SDK v8.22 e mais recente)

Observe: todos os dados obrigatórios (além do vídeo) devem ser empacotados no container antes de iniciar a tela de Liveness.

Para iniciar a gravação, use startActivityForResult:

Kotlin

val sessionToken: String = getSessionToken()
val captureRequest = CaptureRequest(
    listOf(
        AnalysisProfile(
            Analysis.Type.QUALITY,
            listOf(MediaRequest.ActionMedia(OzAction.Blank)),
        )
    )
)
val intent = OzLivenessSDK.createMediaCaptureScreen(captureRequest, sessionToken)
startActivityForResult(intent, REQUEST_LIVENESS_CONTAINER)

Para cenários com múltiplos gestos

val sessionToken: String = getSessionToken()
val captureRequest = CaptureRequest(
    listOf(
        AnalysisProfile(
            Analysis.Type.QUALITY,
            listOf(
                MediaRequest.ActionMedia(OzAction.Blank),
                MediaRequest.ActionMedia(OzAction.Smile)
            ),
        )
    )
)
val intent = OzLivenessSDK.createMediaCaptureScreen(captureRequest, sessionToken)
startActivityForResult(intent, REQUEST_LIVENESS_CONTAINER)

Para obter o container, use onActivityResult:

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_LIVENESS_CONTAINER) {
        when (resultCode) {
            OzLivenessResultCode.SUCCESS -> runAnalysis(OzLivenessSDK.getContainerFromIntent(data))
            OzLivenessResultCode.USER_CLOSED_LIVENESS -> { /* o usuário fechou a tela */ }
            else -> {
                val errorMessage = OzLivenessSDK.getErrorFromIntent(data)
                /* mostrar erro */
            }
        }
    }
}

Se usar fragment, consulte o exemplo abaixo. LivenessFragment é a Fragment representação da interface de usuário da tela de Liveness.

childFragmentManager.beginTransaction()
    .replace(android.R.id.content, LivenessFragment.create(createCaptureRequest(), sessionToken))
    .commit()

childFragmentManager.setFragmentResultListener(OzLivenessSDK.Extra.REQUEST_CODE, this) { _, result ->
    when (val resultCode = result.getInt(OzLivenessSDK.Extra.EXTRA_RESULT_CODE)) {
        OzLivenessResultCode.SUCCESS -> {
            val container = result.getParcelable(OzLivenessSDK.Extra.EXTRA_DATA_CONTAINER) as? DataContainer
            /* Executar análise */
        }
        OzLivenessResultCode.USER_CLOSED_LIVENESS -> { /* o usuário fechou a tela */ } 
        else -> { /* Mostrar erro */ }
    }
}

SDK 8.21 e anteriores

Para iniciar a gravação, use ostartActivityForResult método:

Kotlin

val intent = OzLivenessSDK.createStartIntent(listOf(OzAction.Smile, OzAction.Blank))
startActivityForResult(intent, REQUEST_CODE)

Java

List<OzAction> actions  = Arrays.asList(OzAction.Smile, OzAction.Scan);
Intent intent = OzLivenessSDK.createStartIntent(actions);
startActivityForResult(intent, REQUEST_CODE);

actions – uma lista de ações do usuário durante a gravação de vídeo.

Para Fragment, use o código abaixo. LivenessFragment é a Fragment representação da interface de usuário da tela de Liveness.

Para garantir que a licença seja processada corretamente, recomendamos inicializar o SDK primeiro e, em seguida, abrir a tela de Liveness.

Kotlin

childFragmentManager.beginTransaction()
    .replace(R.id.content, LivenessFragment.create(actions))
    .commit()
// inscrevendo-se no resultado do Fragment
childFragmentManager.setFragmentResultListener(OzLivenessSDK.Extra.REQUEST_CODE, this) { _, result ->
    when (result.getInt(OzLivenessSDK.Extra.EXTRA_RESULT_CODE)) {
        OzLivenessResultCode.SUCCESS -> { /* iniciar análise */ }
        else -> { /* mostrar erro */ }  
    }
}

Java

getSupportFragmentManager().beginTransaction()
        .replace(R.id.content, LivenessFragment.Companion.create(actions, null, null, false))
        .addToBackStack(null)
        .commit();
// inscrevendo-se no resultado do Fragment
getSupportFragmentManager().setFragmentResultListener(OzLivenessSDK.Extra.REQUEST_CODE, this, (requestKey, result) -> {
            switch (result.getInt(OzLivenessSDK.Extra.EXTRA_RESULT_CODE)) {
                case OzLivenessResultCode.SUCCESS: {/* start analysis */}
                default: {/* show error */}
            }
        });

Para obter o vídeo capturado, use oonActivityResult método:

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
  super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE) {
      sdkMediaResult = OzLivenessSDK.getResultFromIntent(data)
      sdkErrorString = OzLivenessSDK.getErrorFromIntent(data)
    }
}

Java

@Override
protected void onActivityResult(int requestCode, int resultCode, @androidx.annotation.Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE) {
        List<OzAbstractMedia> sdkMediaResult = OzLivenessSDK.INSTANCE.getResultFromIntent(data);
        String sdkErrorString = OzLivenessSDK.INSTANCE.getErrorFromIntent(data);
    }

• sdkMediaResult – um objeto com resultados de captura de vídeo para interações com Oz API (uma lista dos OzAbstractMedia objetos),

• sdkErrorString – descrição de erros, se houver.

Se o SDK for usado apenas para capturar vídeos, omita a etapa Verificando Liveness e BIOMETRY facial.

Se um usuário fechar a tela de captura manualmente, resultCode recebe o Activity.RESULT_CANCELED valor.

Exemplo de código:

when (resultCode) {
    Activity.RESULT_CANCELED -> *USUÁRIO FECHOU A TELA*
    OzLivenessResultCode.SUCCESS -> {
        val sdkMediaResult = OzLivenessSDK.getResultFromIntent(data)
        *SUCCESS*
    }
    else -> {
        val errorMessage = OzLivenessSDK.getErrorFromIntent(data)
        *FALHA*
    }
}