1
VoiceChatInitProps
2
StartNewChatProps
3
ChatLifeCycleEvent
4
voice_chat_init()
5
start_new_chat()
6
"chat"
7
"chat_vad"

1
                    控制命令向下
2
┌──────────────────────────────────────────────┐
3
│ 玩具业务：FSM / paipop_engine_service        │
4
└────────────────────┬─────────────────────────┘
5
                     │ Paipop_* 公共 API
6
                     ▼
7
┌──────────────────────────────────────────────┐
8
│ PaipopSDK                                    │
9
│ 公共契约 / 自动认证 / 参数转换 / 回调转换    │
10
└────────────────────┬─────────────────────────┘
11
                     │ LingXin 私有 API
12
                     ▼
13
┌──────────────────────────────────────────────┐
14
│ LingXinSDK                                   │
15
│ 对话状态机 / 协议 / ASR / LLM / TTS          │
16
└────────────────────┬─────────────────────────┘
17
                     │ 引擎请求录音与播放能力
18
                     ▼
19
┌──────────────────────────────────────────────┐
20
│ Paipop 音频反向桥接                          │
21
│ lingxin_* → paipop_audio_*                   │
22
└────────────────────┬─────────────────────────┘
23
                     │ 平台端口
24
                     ▼
25
┌──────────────────────────────────────────────┐
26
│ AC79：ADC / audio_server / DAC               │
27
└──────────────────────────────────────────────┘
28

29
                    异步事件向上
30
LingXin 回调 → Paipop 生命周期事件 → 产品事件 → FSM

1
Paipop_VoiceChatInitProps props;
2

3
Paipop_GetVoiceChatInitDefaultProps(&props);
4
props.lifeCycleListener = paipop_engine_lifecycle_event;
5
props.welcomeAudioPath = PAIPOP_TONE_WAKE;
6
Paipop_VoiceChatInit(&props);

1
Paipop_VoiceChatInitProps props;
2
props.lifeCycleListener = callback;
3
Paipop_VoiceChatInit(&props);

1
memset(props, 0, sizeof(*props));

1
int paipop_engine_chat_init(void)

1
paipop_engine_chat_init()
2
    ↓ direct
3
Paipop_GetVoiceChatInitDefaultProps()
4
    ↓
5
产品覆盖提示音、心跳、回调、动作校验等策略
6
    ↓ direct
7
Paipop_VoiceChatInit()
8
    ↓ direct
9
Paipop_AuthEnsure()
10
    ↓ direct
11
Paipop_AuthInit(Paipop_GetConfiguredKey())
12
    ↓ HTTP 适配边界
13
Paipop 服务返回认证与完整配置
14
    ↓
15
缓存 app_id / license / app_code / server config
16
    ↓
17
Paipop 参数转换成 VoiceChatInitProps
18
    ↓ callback-registration
19
注册 paipop_lifecycle_bridge
20
    ↓ direct
21
voice_chat_init()
22
    ↓
23
LingXinSDK 创建对话运行时能力

1
产品设备 key
2
    ↓
3
Paipop_AuthEnsure()
4
    ↓
5
Paipop_AuthInit()
6
    ↓
7
请求 Paipop 配置服务
8
    ↓
9
解析并缓存：
10
app_id / license / app_code / server_config_response
11
    ↓
12
通过 getter 回调提供给 LingXinSDK

1
static char *g_paipop_key;
2
static char *g_app_id;
3
static char *g_license;
4
static char *g_app_code;
5
static char *g_server_config_response;

1
char *new_key;
2
char *new_app_id;
3
char *new_license;
4
char *new_app_code;
5
char *new_server_config_response;

1
获取新响应
2
    ↓
3
完整解析所有字段
4
    ↓
5
复制所有必要字符串
6
    ↓
7
全部成功？
8
 ┌──┴──┐
9
 否    是
10
 ↓      ↓
11
释放临时值  清理旧缓存并一次性替换

1
app_id 是新的
2
license 是旧的
3
app_code 获取失败

1
Paipop_GetConfiguredKey()

1
const char *Paipop_GetConfiguredKey(void)
2
{
3
    return PAIPOP_ENGINE_DEVICE_KEY;
4
}

1
libpaipop_sdk.a
2
    │ 未解析引用 Paipop_GetConfiguredKey
3
    ▼
4
应用编译 paipop_config.c
5
    │ 提供具体实现
6
    ▼
7
链接阶段完成绑定

1
typedef enum {
2
    PAIPOP_CHAT_MODE_CLOUD_VAD = 0,
3
    PAIPOP_CHAT_MODE_MANUAL_STOP = 1
4
} Paipop_ChatMode;

1
chat_vad
2
chat

1
switch (props->chatMode) {
2
case PAIPOP_CHAT_MODE_CLOUD_VAD:
3
    /* 保留底层默认 chat_vad */
4
    break;
5

6
case PAIPOP_CHAT_MODE_MANUAL_STOP:
7
    inner_props.task = "chat";
8
    break;
9

10
default:
11
    return -1;
12
}

1
disableWelcomeAudio → disable_welcome_audio
2
singleRound        → single_round
3
conversationId     → task_id
4
prompt             → user_input

1
typedef enum {
2
    PAIPOP_START_CHAT_ACCEPTED = 0,
3
    PAIPOP_START_CHAT_ERROR = -1,
4
    PAIPOP_START_CHAT_NOT_READY = -2,
5
    PAIPOP_START_CHAT_BUSY = -3
6
} Paipop_StartChatResult;

1
Paipop_StartNewChat() 返回 0
2
        ↓
3
启动请求已被底层接受
4
        ↓
5
随后才可能收到 STARTING
6
        ↓
7
录音真正准备好后收到 INPUTING

1
static void paipop_lifecycle_bridge(
2
    ChatLifeCycleEvent event,
3
    void *payload)

1
{
2
  "type": "action_list",
3
  "result": [
4
    {"action": "set_volume", "params": {"volume": 40}}
5
  ]
6
}

1
先解析整条列表
2
    ↓
3
先验证所有动作
4
    ↓
5
全部通过
6
    ↓
7
才逐条发布 ACTION 事件

1
验证第 1 条 → 立即执行
2
验证第 2 条 → 发现非法

1
source = PAIPOP_ACTION_SOURCE_NATIVE;
2
ttl_ms = 15000;

1
paipop_engine_lifecycle_event()

1
PAIPOP_CHAT_PHASE_STARTING
2
    ↓
3
PAIPOP_EVT_ENGINE_PHASE_STARTING
4

5
PAIPOP_CHAT_PHASE_INPUTING
6
    ↓
7
PAIPOP_EVT_ENGINE_PHASE_INPUTING
8

9
PAIPOP_CHAT_PHASE_THINKING
10
    ↓
11
PAIPOP_EVT_ENGINE_PHASE_THINKING
12

13
PAIPOP_CHAT_PHASE_OUTPUTING
14
    ↓
15
PAIPOP_EVT_ENGINE_PHASE_OUTPUTING

1
PAIPOP_EVT_ENGINE_EXIT
2
PAIPOP_EVT_ENGINE_WS_FAIL

1
LingXin 生命周期枚举
2
        ↓
3
Paipop 生命周期枚举
4
        ↓
5
玩具产品事件
6
        ↓ queue hop
7
app_core
8
        ↓
9
玩具 FSM

1
业务 → PaipopSDK → LingXinSDK

1
LingXinSDK → Paipop 音频桥 → AC79 平台实现

1
lingxin_recorder_create()
2
lingxin_recorder_open()
3
lingxin_recorder_close()
4
lingxin_recorder_destroy()

1
CONFIG_AUDIO_RECORDER_SAMPLERATE
2
CONFIG_AUDIO_RECORDER_CHANNEL
3
CONFIG_AUDIO_ADC_CHANNEL_L
4
CONFIG_AUDIO_ADC_GAIN

1
静态库内部：
2
    编译 paipop_audio_port_bridge.c
3

4
最终应用：
5
    编译 paipop_audio_recorder.c
6
    编译 paipop_cloud_audio_play.c
7
    编译 paipop_local_audio_player.c

1
Paipop_RecorderCreate()
2
lingxin_recorder_create()
3
paipop_audio_recorder_create()

1
Paipop_RecorderCreate()
2
    ↓
3
lingxin_recorder_create()

1
lingxin_recorder_create()
2
    ↓
3
paipop_audio_recorder_create()

1
Paipop_Free()

1
Paipop_Malloc()
2
    ↓
3
_lingxin_malloc_internal_()
4

5
Paipop_Free()
6
    ↓
7
_lingxin_free_internal_()

1
static Paipop_ChatLifeCycleEventListener g_lifecycle_listener;
2
static void *g_lifecycle_user_data;
3
static Paipop_ActionValidator g_action_validator;
4
static Paipop_ChatRoundPrepareFunc g_round_prepare;

1
(ASREventListener)listener
2
(lingxin_recorder_callback_t)callback

1
稳定公共 API
2
    +
3
统一认证与凭据所有权
4
    +
5
参数、阶段、文字和动作语义转换
6
    +
7
AC79 录放音依赖注入
8
    +
9
静态库与板级源码的发布分层