arcs/SDK服务切换说明.md

SDK 服务切换说明

本文档说明 arcs-mini 固件如何在 Lingxin SDK 和原来的 39 服务之间切换。

配置位置

修改文件：

apps/arcs-mini/prj.conf

核心开关：

CONFIG_ARCS_USE_LINGXIN_SDK=y

切到 Lingxin SDK

在 apps/arcs-mini/prj.conf 中保留：

CONFIG_ARCS_USE_LINGXIN_SDK=y

该宏会自动启用以下配置：

# 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 的云端地址仍然使用：

CONFIG_LINGXIN_CLOUD_HOST="eagent.edu-aliyun.com"
CONFIG_LINGXIN_CLOUD_PORT=80

切回 39 服务

把 apps/arcs-mini/prj.conf 中的：

CONFIG_ARCS_USE_LINGXIN_SDK=y

改成：

# CONFIG_ARCS_USE_LINGXIN_SDK is not set

或者直接删除这一行。

这样会回到默认的 LSChat 链路，也就是原来的 39 服务。

重新打包

切换配置后需要重新打包：

docker run --rm -it --init -w $PWD -v $PWD:$PWD arcs-builder ./build.sh -S ./apps/arcs-mini -C

检查是否切换成功

打包完成后查看生成的配置：

rg -n "CONFIG_ARCS_USE_LINGXIN_SDK|CONFIG_VOICE_LINK_LSCHAT|CONFIG_VOICE_LINK_LINGXIN|CONFIG_LINGXIN_ENGINE_ENABLE" build/.config

Lingxin SDK 状态

如果看到：

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 服务状态

如果看到：

# 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。