初始化

初始化位置

在应用加载时初始化 SDK——通常在 Application 类或入口 Activity 的 onCreate 中进行。SDK 与后端的认证需要几秒钟时间，提前初始化可避免用户点击采集按钮到相机打开之间出现延迟。更多详情请参阅最佳实践。

通过 AcessoBioConfigDataSource 进行配置

创建一个实现 AcessoBioConfigDataSource 的类，并暴露从 Onboarding 团队获取的凭据：

Kotlin

UnicoConfig.kt

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

class UnicoConfig : AcessoBioConfigDataSource {
  override fun getBundleIdentifier(): String = BUNDLE_IDENTIFIER
  override fun getHostKey(): String = SDK_KEY
}

Java

UnicoConfig.java

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;

public class UnicoConfig implements AcessoBioConfigDataSource {
  @Override
  public String getBundleIdentifier() {
    return BUNDLE_IDENTIFIER;
  }

  @Override
  public String getHostKey() {
    return SDK_KEY;
  }
}

环境选择

沙箱与生产环境的选择在初始化时决定。在构建 SDK 实例时，通过 setEnvironment 传入所需的环境：

Kotlin

var acessoBioBuilder: IAcessoBioBuilder = AcessoBio(activity, createCallback()).apply {
  setEnvironment(Environment.UAT)
}

Java

IAcessoBioBuilder acessoBioBuilder = new AcessoBio(activity, createCallback());
acessoBioBuilder.setEnvironment(Environment.UAT);

有关可用环境类型的完整列表，请参阅 API 参考 > 初始化 API。

配置相机模式

从 acessoBioBuilder 构建 UnicoCheckCamera 实例，配置智能采集行为和语言：

Kotlin

val unicoCheckCamera: UnicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .setLocale(LocaleTypes.EN_US)
    .build()

Java

UnicoCheckCamera unicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .setLocale(LocaleTypes.EN_US)
    .build();

提示

setAutoCapture 和 setSmartFrame 的 true/false 值不会改变采集体验——它们仅用于 SDK 的内部逻辑。