抖音小程序视频发布能力中 mentionMarkers 在 iOS 与 HarmonyOS 上的表现差异及异常。
我们在开发抖音小程序的过程中发现了一个关于视频发布时 @ 用户能力的问题,经过多次测试,iOS 和 HarmonyOS 两个平台的表现不一致,而且 IOS 端出现了一个与预期不符的现象。现将具体情况整理如下,希望平台能够协助确认和修复。
我们的小程序使用了 Page.onUploadDouyinVideo 这个钩子,在用户点击发布视频按钮后,返回 UploadParam 对象,其中 titleConfig 里包含 mentionMarkers 字段,用来在视频标题里 @ 活动创建者。根据官方文档,MentionMarker 的 openId 字段说明是“该 mentionMarker 提醒的人,表现为 @xxx”,文档里没有明确说明这个 openId 必须是哪一种来源。我们传入的 openId 是通过后端 code2Session 接口换取的小程序 openid,也就是用户在我们这个小程序里的唯一标识。
测试之后发现,iOS 和 HarmonyOS 的表现完全不同。
在 iOS 上,传入 mentionMarkers 之后,发布的视频标题里只显示了 @昵称 这几个字,但它只是一段普通文字,没有变成可点击的 @ 链接,点击没有任何反应,也就是说 @ 并没有真正生效。还有一个小问题是,在{start:0,openId: openId}这部分代码中,当start=0时,@昵称 这几个字也会消失。
在 HarmonyOS 上,传入同样的 mentionMarkers,也就是同样的小程序 openid,发布视频后标题里的 @ 标记却真正 @ 到了人,点击可以跳转到对方的主页,@ 是生效的。
这里让我们感到困惑的是,如果 HarmonyOS 端能够 @ 成功,说明发布器在解析 mentionMarkers 的时候,可能把小程序 openid 当作了某种可识别的用户标识来处理。而 iOS 端则完全没有建立 @ 链接,只显示了文字。两端行为不一致,给我们的开发和用户体验都带来了困扰。
我们期望平台能够帮忙确认几个问题。第一,mentionMarkers 的 openId 字段传的是通过后端 code2Session 接口换取的小程序 openid。第二,iOS 和 HarmonyOS 的行为为什么不一致,哪一端的表现是符合预期的。第三,如果 HarmonyOS 端 @ 成功属于异常行为,希望平台能够明确并修复;如果 iOS 端 @ 失败属于异常,也希望 iOS 端能够尽快对齐 HarmonyOS 的表现。
复现步骤比较简单。在小程序里使用 button open-type 为 uploadDouyinVideo 的按钮触发 onUploadDouyinVideo,返回 UploadParam,其中 titleConfig.mentionMarkers 传入小程序 openid。然后在 iOS 和 HarmonyOS 设备上分别发布视频,观察标题里的 @ 表现即可。
我们的测试环境是,基础库版本在 2.65.0 以上,iOS 端抖音版本为 15.9.0,HarmonyOS 端版本为 HarmonyOS 4.2,测试时间是 2026 年 9 月 27 日。
希望平台能够协助定位这个问题,明确 mentionMarkers 的正确用法,并统一两端的行为,避免开发者在使用这个能力时产生困惑。
