Appearance
深色模式
APP 切到深色,客服页面跟着一起变,不会只剩客服页还亮着。
默认就是跟随 APP
不配任何东西时,客服页面跟随你的 APP 当前的深浅色。用户在 APP 里切换主题,客服页面同步切换。
| 浅色 | 深色 |
|---|---|
![]() | ![]() |
这是多数 APP 想要的效果,所以做成了默认值,你不用写代码。
四档取值
需要别的行为时,在配置里指定 colorScheme:
| 取值 | 效果 |
|---|---|
host(默认) | 跟随你的 APP 当前的深浅色,APP 切换时同步切换 |
light | 始终浅色 |
dark | 始终深色 |
auto | 由工作台的渠道设置决定 |
kotlin
// Android
HecongChatConfig("你的渠道ID").apply { colorScheme = "dark" }swift
// iOS
let config = HecongChatConfig(channelId: "你的渠道ID")
config.colorScheme = "dark"想让工作台说了算,要显式配 auto
工作台的 聊天窗口 里有一个深浅色配置项,网页接入和对话链接都受它管。APP 这边默认不受它管 —— 默认值是跟随你的 APP,这是显式的选择,会压过工作台的配置。
想把决定权交回工作台,把 colorScheme 配成 auto。这时工作台配了浅色或深色就按那个来,配的是跟随时按客户的系统偏好来。
这不是改颜色的接口
四档取值只决定用浅色还是深色,具体的配色仍然是工作台里配好的那套。深色版的配色会自动生成,不用单独配。
要改主题色、换配色方案,入口只有工作台一个:设置 > 渠道管理 > 聊天窗口。

