SDK FAQ
最近更新时间：2023.08.16 11:23:13
首次发布时间：2022.10.20 15:38:15
错误码
| 错误码名称 | 错误码 | 含义 |
|---|---|---|
| SAMI_OK | 0 | 成功 |
| SAMI_FAIL | 1 | 失败 |
| SAMI_EXCEPTION_OCCURRED | 2 | 发生了异常，请检查使用的和输入参数 |
| SAMI_PARAM_ERROR | 100001 | 输入的参数有误 |
| SAMI_NOT_SUPPORT | 100002 | SDK不支持这个功能 |
| SAMI_NOT_IMPLEMENTATION | 100003 | SDK不支持这个功能，请联系支持确认 |
| SAMI_JNI_PARSE_ERROR | 100004 | JNI参数解析出错，请确认使用是否正确 |
| SAMI_NOT_SUPPORTED_SAMPLE_RATE | 100005 | 创建的handle不支持指定的采样率 |
| SAMI_NOT_SUPPORTED_CHANNEL_LAYOUT | 100006 | 指定的通道的数据的布局不支持，默认仅支持planner布局 |
| SAMI_TOKEN_EXPIRED | 100007 | 授权过期 |
| SAMI_TOKEN_PARSE_FAILED | 100008 | token解析出错 |
| SAMI_TOKEN_APPKEY_NOT_MATCH | 100009 | appkey和token不匹配 |
| SAMI_CONTEXT_NOT_INIT | 100010 | 在创建handle之前没有调用授权接口 |
| SAMI_SERVER_REQUEST_FAILED | 100011 | 在线能力请求服务错误的 |
| SAMI_READ_FILE_FAILED | 100012 | sdk内部读取文件失败，确认文件是否存在和载体是否有读文件的权限 |
| SAMI_BLOCK_ERROR | 100014 | 输入的block格式错误 |
| SAMI_IDENTIFI_NO_METHODID | 100015 | 当前功能不支持tob使用 |
| SAMI_TOKEN_NO_FIND_METHODID | 100016 | token不支持当前的功能，请确认token的授权范围 |
| SAMI_NOT_SUPPORT_PARAM | 100017 | 不支持的参数类型 |
| SAMI_TOKEN_NOT_SUPPORT_PLATFORM | 100018 | token不支持运行在当前的平台，请确认token的授权范围 |
| SAMI_TOKEN_NOT_SUPPORT_PACKAGE_NAME | 100019 | token不支持运行在当前的app，请确认token的授权范围 |
| SAMI_TOKEN_DEVICEID_NOT_MATCH | 100020 | 设备授权的token和申请的设备id不一致 |
| SAMI_TOKEN_NOT_GET_DID | 100021 | 获取不到设备的id（设备唯一码） |
| SAMI_VC_TASK_TYPE_NOT_MATCH | 100022 | vc功能的音色未授权 |
| SAMI_TOKEN_NOT_SUPPORT_ONLINE | 100023 | token不带在线功能的授权 |
| SAMI_TOB_CE_AUTH_MODEl_NO_MATCH_ID | 100024 | 使用的模型和id不匹配 |
| SAMI_CREATE_PROCESSOR_FAIL | 110001 | 创建处理器失败 |
| SAMI_PROCESSOR_NOT_PREPARED | 110002 | 创建处理之后没有调用prepare接口 |
| SAMI_PROCESSOR_IN_OUT_NOT_EQUAL | 110003 | 等进等出的处理器，输入的大小不一致，注意audioBuffer->numberSamples |
| SAMI_PROCESSOR_SET_STATE_FAIL | 110004 | 处理器更新参数失败 |
| SAMI_PROCESSOR_JNI_BUFFER_NOT_EQUAL_IN | 110005 | 调用process输出的数据类型不符合handle要求 |
| SAMI_PROCESSOR_JNI_OUT_BUFFER_LESS_NEED | 110006 | 调用process的帧数大于创建的时候的max_block_size |
| SAMI_ENGINE_CREATE_ERROR | 150001 | 引擎创建失败，检测创建参数是否正确 |
| SAMI_ENGINE_INPUT_NEED_MORE_DATA | 150002 | 输入的数据小于算法处理的最小长度，继续输入数据即可 |
| SAMI_IO_FILE_SOURCE_CREATE_ERROR | 195001 | 文件读取失败，请检查路径是否正确，是否有读取权限 |
| SAMI_IO_AUDIO_ENCODER_CREATE_ERROR | 195002 | 文件编码失败，请检查路径是否正确，是否有写入权限 |
| 其他错误 | 请联系相关业务负责人 |
常见问题
- 调用SAMICoreInitContext(SAMICoreContextType type, void* params)crash
原因：offlineParameter.extra需要置空,建议使用memset，后续版本升级也不会引进新问题
SAMICoreTokenVerifyOfflineParameter offlineParameter; memset(&offlineParameter, 0, sizeof(offlineParameter)); offlineParameter.token = "your-token"; offlineParameter.appKey = "your-appkey"; offlineParameter.extra = nullptr; SAMICoreInitContext(SAMICoreContextType::TokenVerifyOfflineContext, &offlineParameter); if(ret != SAMI_OK) { std::cout << "init offline token context failed" << std::endl; return; }
- maxBlockSize 参数含义
maxBlockSize 即一次输入给SDK 处理的每个通道最大采样点数量 (numSamples)
- A/libc: Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0x0 in tid 3058 (Thread-3), pid 2491 (edance.javademo)报错
原因：一般是输入SDK 数据的样本数量超出了 maxBlockSize 限定。
- android提示缺少libc++_shared.so
sdk需要ndk里面的c++标准库，如果业务的工程本身不带，从依赖库中找到对应cpp_shared-21.0.0-sami.aar并增加依赖