11月2日，小鹅通开放平台更新了鸿蒙端接入文档，SDK 包名 @xe/webcore 的版本来到 1.0.11，包体 112.2KB，从华为鸿蒙的 ohpm 仓库就能下载。这个包解决的是一件很具体的事，商家自己的鸿蒙 App 里，可以直接跑小鹅通的店铺页面。

为什么有人在意这件事。大部分商家用小鹅通，页面在 H5 或者小程序里流转，微信生态内部就闭环了。但也有一部分商家做了自己的 App，用户在 App 里看课、下单、进直播间，体验比跳出去再回来顺。鸿蒙设备这两年铺开，这些 App 迟早要出鸿蒙版，店铺页面怎么嵌进去，就成了摆在桌面上的问题。

按官方文档的说法，这个 SDK 能在 App 内嵌的 H5 页面里做账号打通和内容交付与分销，支付营销、直播课程这些商家最看重的能力也在列，页面分享、外链处理和图片音频交互一并包了进来。翻译成商家的话就是，用户在你的 App 里登录看课、下单付款，都不用跳出去了。

边界同样写在文档里。当前这个内嵌 SDK 暂不支持直播连麦、直播浮窗和涨粉神器，这一条对做私域直播的商家影响最直接。直播课程能播，单向观看没有问题，要在 App 里做连麦互动、答疑上麦，这条路暂时走不通。这类商家眼下只有两个选择，把连麦环节留在小鹅通自己的直播间，或者等 SDK 后续版本把能力补上。

接入前要备齐三样东西。已经开通小鹅通店铺，从管理台拿到店铺 app_id；内嵌 SDK 服务要单独开通，开通后从管理台拿 client_id，商家在小鹅通开通店铺时默认不一定带这项，找小鹅通客服确认比自己翻后台快；开发团队那边装好 DevEco Studio 和对应的 HarmonyOS SDK。文档还列了验证过的环境组合，DevEco Studio 5.0.1 Beta3 配 API 13 的 SDK，ROM 是 5.0.0.106，其他版本能不能跑要以实测为准。

这次 1.0.11 的更新内容本身不大，主要加了一组可选个人信息能力开关，包含相册选图和录音两项，默认都开着，可以在初始化时按需关闭。改动的背景是合规。App 接了第三方 SDK，个人信息收集要能说清来路，监管问起来，宿主 App 要能证明哪些权限是自己申请的，哪些来自 SDK 页面。

关闭的具体效果文档写得很细。关掉相册选图，页面调用选图会提示功能暂不可用并返回失败，不会拉起系统图片选择器。录音关掉后同理，页面调用会返回失败，也不申请麦克风权限。文档还提醒，关闭录音时应从 module.json5 里移除麦克风权限声明，两项能力都只在用户主动操作时触发，SDK 不会自己拉起。

开发侧的动作不难。工程根目录执行 ohpm install @xe/webcore 装包，包体配有 MD5 和 SHA-256 校验值可以核对；初始化建议放在 EntryAbility 的 onCreate 里，appId 和 clientId 是必填项，showLog 这个调试开关在生产环境建议关掉。

URL 规则值得单独记一笔。店铺首页的格式是 https 加上 app_id 再加 .h5.xiaoeknow.com，课程这类具体页面从管理台复制链接，SDK 展示时只替换域名部分，路径里的课程 ID 不要动，链接必须走 HTTPS。不少接入问题出在链接上，页面白屏或者登录态丢失，先回来核对 URL 对不对。

登录态是另一个高频坑。文档的常见问题列了三条，页面打开没有登录态，切换账号还显示上一个账号的内容，点分享没有回调。解决办法分别在 init 时机、syncNot 清理和分享回调这三处，最后一条其实不是故障，部分页面本身就不支持分享。像切换账号必须先执行 syncNot 清掉旧 Cookie，再给新账号同步 token，这一步漏了就会出现串号。

分享的机制和微信里不一样。SDK 把分享数据回调给宿主应用，分享面板和目标应用由 App 自己实现，数据里有 share_title、share_content、share_image、share_link 这些字段。在小鹅通 H5 里配置好的分享卡片，到了 App 里长什么样，还得 App 团队自己画。

哪些商家值得动？有技术团队、已经或者准备做鸿蒙 App、店铺内容想在 App 里闭环的，这个 SDK 就是给这条路径准备的。没有 App 的商家不必跟，H5 和小程序已经够用，为一个 SDK 去养一个 App 团队不划算。拿不准自己店铺有没有内嵌 SDK 服务的，上小鹅通官网后台查一下，或者直接打小鹅通客服电话 400-102-6665 问清楚再排期。

鸿蒙端的这次更新幅度不大，但对做私域直播的商家来说是个明确的信号，小鹅通在把店铺页面往更多终端送。连麦这类重交互还没跟上，先按文档把单向的直播课程嵌进去，把边界留在文档写明的地方，是眼下比较稳的做法。

• 上一篇：小鹅通助手客户端更新，私域直播转播到视频号要留意这几处
• 下一篇：没有了