Android SDK 说明

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    // 口语评测SDK
    implementation files("libs/qcloud-soe-release-VERSION.aar")
    // 口语评测SDK内部依赖的okhttp库（必选）
    implementation 'com.squareup.okhttp3:okhttp:4.2.2'
}

<!-- 录音权限 -->
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<!-- 网络权限 -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Map<String, Object> apiParams = new TreeMap<>();
// 引擎模型类型电话场景:16k_zh:中文; 16k_en:英文;
apiParams.put(HttpParameterKey.SERVER_ENGINE_TYPE, "16k_zh");
// 评测模式
apiParams.put(HttpParameterKey.EVAL_MODE, 1);
//输入文本模式 0: 普通文本(默认)1:音素结构 文本
apiParams.put(HttpParameterKey.TEXT_MODE, 0);
//评价苛刻指数。取值为[1.0 - 4.0]范围内的浮点数
apiParams.put(HttpParameterKey.SCORE_COEFF, 1.0);
// 输出断句中间结果标识，0:不输出(默认) 1:输出
apiParams.put(HttpParameterKey.SENTENCE_INFO_ENABLED, 1);
//被评估语音对应的文本，仅支持中文和英文
apiParams.put(HttpParameterKey.REF_TEXT, "你好");
// 注：录音评测模式下，需要设置HttpParameterKey.REC_MODE的值为1，默认值为0，实时评测模式无需设置该字段
// apiParams.put(HttpParameterKey.REC_MODE, 1);

TAIConfig taiConfig = new TAIConfig.Builder()
        .appID(yourAppId)//appID
        .secretID(yourSecretId) //secretID
        .secretKey(yourSecretKey) //secretKey
        .token(yourToken) //临时token
        .apiParams(apiParams) //api参数，可参考示例代码或HttpParameterKey类
        .enableVAD(true) //是否开启静音检测
        .vadInterval(3000) //静音检测的时间间隔，单位ms
        .vadDBThreshold(20) //静音检测的阈值
        .stopOnVadDetected(true) //是否检测到静音就停止评测
        .dataSource(new TAIDataSource(true)) //实时评测模式下的数据源，TAIDataSource入参为true表示评测过程中需要回调音频数据
        //.recordAudioData(audioData) //录音评测模式下的音频数据流
        .build();

// 1. 通过配置项构造评测类
TAIOralController taiOralController = new TAIOralController(taiConfig);

// 2. 创建评测监听
TAIListener taiListener = new TAIListener() {
      //评测结果回调
      @Override
      public void onMessage(String msg) { }
      //静音检测回调
      @Override
      public void onVad() { }
      //评测结束回调
      @Override
      public void onFinish(String msg) { }
      //评测出错回调
      @Override
      public void onError(OralEvaluationRequest request,
                          ClientException clientException,
                          ServerException serverException,
                          String response) { }
      //音量回调
      @Override
      public void onVolumeDb(float volumeDb) { }
};

// 3. 创建录音监听
OralEvaluationStateListener oralEvaluationStateListener = new OralEvaluationStateListener() {
    //录音开始回调
    @Override
    public void onStartRecord(OralEvaluationRequest request) { }
      //录音结束回调
    @Override
    public void onStopRecord(OralEvaluationRequest request) { }
        //录音数据回调
    @Override
    public void onAudioData(final short[] audioData, final int readBufferLen) { }
};

// 4. 启动评测，如果要监听录音开始
taiOralController.startOralEvaluation(taiListener, oralEvaluationStateListener);

taiOralController.stopOralEvaluation();

taiOralController.cancelOralEvaluation();

public TAIOralController(TAIConfig config)

public void startOralEvaluation(TAIListener listener , OralEvaluationStateListener oralEvaluationStateListener)

public void stopOralEvaluation()

public void stopOralEvaluation()

public void release()

public interface TAIListener {
        //评测结果回调
    void onMessage(String msg);
    //静音检测回调，静音检测相关的功能仅在VOICE_FORAMT=0时生效，即pcm格式音频时生效
    void onVad();
        //评测结束回调
    void onFinish(String msg);
        //评测出错回调
    void onError(OralEvaluationRequest request, ClientException clientException, ServerException serverException, String response);
        //音量回调, 音量范围: 0~120
    void onVolumeDb(float volumeDb);
}

public interface OralEvaluationStateListener {
    /**
     * 开始录音时回调
     * @param request
     */
    void onStartRecord(OralEvaluationRequest request);

    /**
     * 结束录音时回调
     * @param request
     */
    void onStopRecord(OralEvaluationRequest request);

    /**
     * 返回音频流，
     * 用于返回宿主层做录音缓存业务。
     * 由于方法跑在sdk线程上，这里多用于文件操作，宿主需要新开一条线程专门用于实现业务逻辑
     * @param audioData
     * @param readBufferLength
     */
    void onAudioData(short[] audioData,int readBufferLength);
}

AAILogger.setLoggerListener(new LoggerListener() {
    @Override
    public void onLogInfo(String s) {

    }
});