LiveViewKit 进度可视化模板(LAYOUT_TYPE_PROGRESS)下,primary.content 设置多段 RichText 时 startLiveView 报 401「length exceeds the limit
【环境信息】
设备型号:【请填写,如 Mate 60 Pro】
HarmonyOS 版本:【请填写,如 HarmonyOS NEXT 5.x.x】
DevEco Studio / SDK 版本:【请填写】
涉及 Kit:Live View Kit(@kit.LiveViewKit),本地实况窗
【问题描述】 应用使用进度可视化模板(layoutData.layoutType = LAYOUT_TYPE_PROGRESS)展示车辆充电进度。需要在固定区 primary.content 展示一行带分色的富文本(标签用弱色、数值用高亮色),如「当前 90% | 预计 11:52 完成充电」。当 primary.content 设置为 5 段 RichText 时:
startLiveView 直接失败:code=401, message="Parameter error. The type of primary.content must be Array<RichText> [or the parameter length exceeds the limit]."
若实况窗已通过单段内容启动,再用 5 段内容调 updateLiveView,返回:{"resultCode":1,"message":"The primary data update failed"}
而当 primary.content 仅设置 1 段(如 [{text:"当前 90%"}])时,startLiveView 返回 resultCode:0 success,可正常显示与更新。
【关键请求体(5 段,失败)】
{"id":1,"event":"RENT","sequence":1,"timer":{"time":0,"isCountdown":false,"isPaused":false},
"liveViewData":{"primary":{"title":"充电中",
"content":[{"text":"当前 ","textColor":"#99FFFFFF"},{"text":"90%","textColor":"#FFFFFFFF"},{"text":" | 预计 ","textColor":"#99FFFFFF"},{"text":"11:52","textColor":"#FFFFFFFF"},{"text":" 完成充电","textColor":"#99FFFFFF"}],
"keepTime":0,"clickAction":{},
"layoutData":{"layoutType":3,"progress":90,"color":"#FF2CAF93","backgroundColor":"#FF4A4A4A","indicatorType":1,"indicatorIcon":"live_view_ic_charging.webp","nodeIcons":["live_view_ic_transparent.svg","live_view_ic_transparent.svg"],"lineType":2}},
"capsule":{"type":1,"status":1,"icon":"live_view_ic_logo.webp","backgroundColor":"#00000000","title":"充电中","content":"90%"}}}
对比:将 content 改为单段 [{"text":"当前 90%","textColor":"#FFFFFFFF"}] 时 startLiveView 成功。
【已排查】
单段 content → start/update 均成功;多段(5 段)→ start 401、update failed,唯一变量是 content 段数。
此前在非进度模板(如强调文本/左右文本模板)下,primary.content 设置多段 RichText 可正常显示,未报错。
官方文档进度可视化模板(配送场景)示例 content 也使用了多段(如「距商家 300 米 | 3 分钟到店」),与本现象矛盾,故怀疑是段数/单段长度/总字符数等存在未公开的限制。
【期望获取的帮助】
LAYOUT_TYPE_PROGRESS 进度模板下,primary.content 的 RichText 数组是否有段数上限或总字符长度上限?具体数值是多少?
该 401「length exceeds the limit」的确切触发条件是按段数、单段字符数、还是整体长度判定?
在进度模板下,若要实现「标签 + 高亮数值」的多段分色文本,官方推荐的正确写法是什么?应放 primary.content 还是 layoutData 的字段?
为何官方进度模板配送示例(多段)可用、而上述请求体不可用?两者差异点在哪?
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题




















































苏公安网备 32011402010933号