翻页宝阅读器在电脑预览、手机微信浏览器和小程序 web-view 三种环境下存在已知行为差异。这些差异是由阅读器内置规则、浏览器限制和会员等级决定的,不是随机的渲染错误。对照下面的现象分类逐项检查,通常能快速定位原因。
现象
- 电脑预览显示双页翻书,手机微信打开变成单页。
- 背景音乐在微信或小程序中打开后不自动播放。
- 小程序里看不到全屏按钮,工具栏部分项目消失。
- 发布后阅读器右上角多了翻页宝品牌入口(「免费制作」)。
- 在微信里转发分享时卡片未显示自定义标题和封面,仍是网页默认截图。
- 小程序中点击「分享」没有弹出分享弹窗,而是出现提示要求点右上角菜单。
- 字体在编辑器里是自定义字体,手机端显示成了系统默认字体。
可能原因
| 现象 | 根本原因 |
|---|---|
| 手机显示单页 | 阅读器自动将 viewport ≤ 768 px 判定为移动端,单双页切换到单页 |
| 背景音频不自动播放 | 浏览器/微信/小程序的媒体自动播放策略,需用户先交互 |
| 全屏按钮消失 | 小程序 web-view 沙箱不支持,系统检测到 ?from=miniprogram 后自动隐藏 |
| 出现翻页宝品牌入口 | 作品发布时账号为免费版,系统按套餐强制显示;升级到基础版及以上可关闭 |
| 微信分享卡片未生效 | 微信 JS-SDK 自定义卡片仅在翻页宝平台域名(fanyebao.com)激活,自定义域名和小程序 web-view 不激活 |
| 小程序分享不弹窗 | 小程序 web-view 不支持翻页宝内置分享弹窗,系统改为引导用右上角原生菜单 |
| 字体回退系统字体 | 自定义字体在客户端加载,字体服务不可用或网络超时时可能回退 |
检查步骤
步骤 1 · 确认预览与发布链接是否真正一致
- 在新版编辑器顶部点击「预览/设置」,用手机视口(375 px 宽)预览,此时应与微信手机端行为相近。
- 保存并重新发布后,用发布链接(
/c/...)在手机微信实际打开,对比与预览是否一致。 - 若预览已有差异,说明设置问题,继续步骤 2;若预览一致但发布后不同,可能是发布前未保存最新设置。
步骤 2 · 单双页问题:检查页面模式设置
阅读器根据实时 viewport 宽度判断是否为移动端(宽度 ≤ 768 px 则视为移动端),并按以下规则决定单双页:
pageMode = auto(默认):移动端强制单页,桌面显示双页。pageMode = single:始终单页,所有设备一致。pageMode = double:桌面显示双页;移动端虽设置双页,仍强制单页(代码行为同auto)。
检查位置:「预览/设置」→「外观」→「书刊外观」→「页面模式」。

若希望手机端也显示双页,当前版本的 pageMode = double 在移动端仍回退为单页,这是固定行为,无法通过设置绕过。
步骤 3 · 背景音频不播放:确认是否触发了用户交互
浏览器和微信对音频自动播放有限制。翻页宝阅读器在首次检测到用户点击或触碰后才会尝试自动激活背景音频(背景音乐的 activationMode = auto 模式)。若读者直接打开页面而没有任何点击动作,音频可能保持静默。
排查方法:
- 确认背景音频设置的「激活方式」是否为「自动」。
- 在手机上打开作品后,点击任意区域翻一页,观察音频是否随后启动。
- 若始终无声,检查音频文件是否可以正常访问,以及设备是否处于静音模式。
背景视频(作为页面背景的视频元素)同样受此限制;浏览器阻止自动播放时视频保持静止,翻页宝不会强制绕过。
步骤 4 · 小程序 web-view 中的已知限制
通过翻页宝小程序(或第三方小程序 web-view 嵌入)访问作品时,翻页宝阅读器会检测到小程序环境(URL 包含 ?from=miniprogram 或页面环境变量 __wxjs_environment === 'miniprogram'),并自动隐藏全屏按钮(该控件在小程序沙箱中不可用)。
分享行为也不同:小程序内点击「分享」后,翻页宝不弹出内置分享弹窗,而是提示读者「请点击右上角菜单分享」,由小程序原生菜单接管分享操作。
这些是阅读器的已知设计行为,不需要进行额外设置。
步骤 5 · 发布后出现翻页宝品牌水印
若发布时账号处于免费版,阅读器顶部右侧会显示「免费制作」入口(品牌水印),这是免费版的固定策略。
解决方法:升级到基础版及以上套餐(remove_branding 功能最低需基础版),重新发布后品牌水印不再显示。
步骤 6 · 微信分享卡片未生效
翻页宝的微信 JS-SDK 自定义分享卡片(设置自定义标题、描述、封面图)有双重激活条件:
- 读者在微信内置浏览器中打开作品;
- 当前访问地址的域名属于翻页宝平台域名(如 fanyebao.com 及其子域)。
两个条件必须同时满足,JS-SDK 才会被激活并下发自定义卡片数据。
不会激活的场景:
- 读者通过作者绑定的自定义域名访问时(退回 og 静态卡片);
- 在微信小程序 web-view 内访问时(小程序 web-view 不走微信 JS-SDK 分享流程);
- 在非微信浏览器(Safari、Chrome、Edge 等)中访问时。
检查方法:在手机微信内打开 fanyebao.com 的阅读链接(/c/... 格式),转发给好友,观察卡片是否显示自定义内容;若是通过自定义域名访问则属已知限制。
步骤 7 · 字体显示为系统字体
自定义字体在阅读器客户端加载。若字体服务访问超时或网络异常,浏览器会回退到系统默认字体,页面文字排版可能出现变化。
检查方法:
- 确认字体文件已上传,未被删除;
- 换一个网络环境(例如从 WiFi 切换到移动数据)重新打开作品,确认是否是偶发网络问题;
- 在编辑器「字体管理」中确认对应字体文件仍正常存在。
解决方案
- 单双页差异:接受移动端单页为当前设计行为;或将页面比例设计为竖向(适合手机单页阅读);无法通过设置强制手机显示双页。
- 背景音频:告知读者需要点击任意位置后音频才会响起;也可将激活方式改为「手动」,在阅读器工具栏展示静音/播放按钮,由读者主动控制。
- 小程序限制:这是小程序 web-view 沙箱的平台限制,无需设置,属于正常行为。
- 品牌水印:升级基础版及以上套餐,重新发布后水印消失。
- 微信分享卡片:确认在分享弹窗「微信卡片」中已配置标题和封面;使用翻页宝平台域名链接分享(非自定义域名)。
- 字体回退:联系客服确认字体服务状态;若字体较多,可尝试使用系统安全字体作为兜底选项。
- 仍无法定位:保留作品链接、设备型号、微信版本和异常截图,提交工单给客服。
