初始化 Linkus Android SDK

使用 Linkus Android SDK 之前,你需要对其进行初始化以启动核心服务和组件。Linkus Android SDK 支持默认初始化及自定义初始化两种方法。

前提条件

限制条件

初始化只能执行一次,且必须在主进程中执行。

背景信息

Linkus Android SDK 默认配置
下表展示了 Linkus Android SDK 的基础配置项及默认值。
配置项 默认值
语音编解码 iLBC
音频自动增益 禁用
回音消除 禁用
音质调试 禁用
主动降噪 启用
呼叫等待 启用
初始化选项
Linkus Android SDK 支持默认初始化及自定义初始化两种方式,选择任意一种方式初始化 Linkus Android SDK。
  • 默认初始化:使用默认的参数配置对 Linkus Android SDK 进行初始化,无需额外设置。

    更多信息,参见 默认初始化 Linkus Android SDK

  • 自定义初始化:使用自定义的参数配置对 Linkus Android SDK 进行初始化。支持为 Linkus Android SDK 自定义以下参数及设置:
    • 音频自动增益
    • 回音消除
    • 主动降噪
    • 呼叫等待
    • Linkus SDK 的信息存储地址

    更多信息,参见 自定义初始化 Linkus Android SDK

默认初始化 Linkus Android SDK

实现方法
在项目的 Application 类的 onCreate() 方法中,调用以下方法对 Linkus Android SDK 进行初始化并应用默认的参数配置。
YlsBaseManager.getInstance().initYlsSDK(this, null);
示例代码

自定义初始化 Linkus Android SDK

实现方法
在项目的 Application 类的 onCreate() 方法中,调用以下方法自定义 Linkus SDK 的基础参数设置并对其进行初始化。
YlsInitConfig config = new YlsInitConfig.Builder(projectPath)//指定 Linkus SDK 信息 (包括日志信息) 的保存地址
        .supportCallWaiting(true)//是否启用呼叫等待;true:启用,false:禁用
        .agc(true)//是否启用音频自动增益;true:启用,false:禁用
        .ec(true)//是否启用回音消除;true:启用,false:禁用
        .nc(true)//是否启用主动降噪;true:启用,false:禁用
        .key("")//可选:指定数据库的访问密码
        .build();//应用以上参数初始化 Linkus SDK
        YlsBaseManager.getInstance().initYlsSDK(this, config);
示例代码

后续步骤

向 PBX 服务器请求 SDK 登录签名,用于用户鉴权及登录 Linkus Android SDK。

更多信息,参见 获取 Linkus Android SDK 登录签名