Files
arcs/SDK服务切换说明.md
2026-08-13 16:50:52 +08:00

111 lines
2.1 KiB
Markdown

# SDK 服务切换说明
本文档说明 arcs-mini 固件如何在 Lingxin SDK 和原来的 39 服务之间切换。
## 配置位置
修改文件:
```text
apps/arcs-mini/prj.conf
```
核心开关:
```conf
CONFIG_ARCS_USE_LINGXIN_SDK=y
```
## 切到 Lingxin SDK
`apps/arcs-mini/prj.conf` 中保留:
```conf
CONFIG_ARCS_USE_LINGXIN_SDK=y
```
该宏会自动启用以下配置:
```conf
# CONFIG_VOICE_LINK_LSCHAT is not set
CONFIG_VOICE_LINK_LINGXIN=y
CONFIG_LS_CHAT=y
CONFIG_SERVER_VOICE_LSCHAT=y
CONFIG_LINGXIN_ENGINE_ENABLE=y
CONFIG_LINGXIN_ENGINE_PROFILE_CHAT_CORE=y
CONFIG_LINGXIN_USER_TRACK_STUB=y
```
Lingxin 的云端地址仍然使用:
```conf
CONFIG_LINGXIN_CLOUD_HOST="eagent.edu-aliyun.com"
CONFIG_LINGXIN_CLOUD_PORT=80
```
## 切回 39 服务
`apps/arcs-mini/prj.conf` 中的:
```conf
CONFIG_ARCS_USE_LINGXIN_SDK=y
```
改成:
```conf
# CONFIG_ARCS_USE_LINGXIN_SDK is not set
```
或者直接删除这一行。
这样会回到默认的 LSChat 链路,也就是原来的 39 服务。
## 重新打包
切换配置后需要重新打包:
```bash
docker run --rm -it --init -w $PWD -v $PWD:$PWD arcs-builder ./build.sh -S ./apps/arcs-mini -C
```
## 检查是否切换成功
打包完成后查看生成的配置:
```bash
rg -n "CONFIG_ARCS_USE_LINGXIN_SDK|CONFIG_VOICE_LINK_LSCHAT|CONFIG_VOICE_LINK_LINGXIN|CONFIG_LINGXIN_ENGINE_ENABLE" build/.config
```
### Lingxin SDK 状态
如果看到:
```conf
CONFIG_ARCS_USE_LINGXIN_SDK=y
# CONFIG_VOICE_LINK_LSCHAT is not set
CONFIG_VOICE_LINK_LINGXIN=y
CONFIG_LINGXIN_ENGINE_ENABLE=y
```
说明当前是 Lingxin SDK。
### 39 服务状态
如果看到:
```conf
# CONFIG_ARCS_USE_LINGXIN_SDK is not set
CONFIG_VOICE_LINK_LSCHAT=y
# CONFIG_VOICE_LINK_LINGXIN is not set
```
说明当前是 39 服务。
## 注意事项
- 这个宏只负责切换 SDK 链路。
- 39 服务的 websocket 地址如果在其他配置或代码里已经改过,不需要因为这个宏再改一遍。
- 每次切换后都要重新打包,并烧入新的 `arcs-mini.bin`
- 如果资源也有变化,需要同时烧入完整资源 bin。