← 返回列表

H5落地页开发说明

用于说明 APP 分享视频链接到微信,再从微信跳浏览器打开 H5 落地页时的完整交互流程、端差异、唤起策略、下载跳转与前端实现要点。

APP分享视频链接到微信 → 浏览器打开完整交互流程

一、整体流程图

用户点击微信中分享链接
    ↓
微信浏览器打开H5落地页
    ↓
H5页面加载视频信息(封面、标题、作者、互动数据等)
    ↓
页面自动检测环境(iOS / Android)
    ↓
检测手机是否已安装APP
    ↓
┌─────────────────┴─────────────────┐
│                                   │
已安装APP                          未安装APP
│                                   │
页面显示「打开APP」按钮             页面显示「下载APP」按钮
点击尝试唤起APP                    点击跳转至统一下载页
│                                   │
唤起成功 → 跳转APP视频详情页        下载页自动识别系统跳转对应应用商店
唤起失败 → 弹窗引导手动打开或下载

二、H5页面元素

区域内容数据来源
视频播放器封面图+播放按钮,点击播放视频视频URL
作者信息头像、昵称用户信息接口
互动数据有用数、评论数、收藏数视频详情接口
操作按钮有用、评论、收藏、转发前端UI,点击引导跳转APP
底部操作栏打开APP / 下载APP根据环境动态展示

三、APP检测逻辑

3.1 环境检测(后端或前端)

// 通过User-Agent判断
iOS设备:包含 iPhone / iPad
Android设备:包含 Android
微信内置浏览器:包含 MicroMessenger

3.2 是否安装APP检测

iOS(Universal Link):

Android(URL Scheme + 剪贴板):

3.3 推荐方案

端检测方式说明
iOSUniversal Link苹果推荐方案,系统级支持,已安装自动唤起
AndroidURL Scheme + 超时检测通过尝试唤起,3秒超时判断安装状态

四、页面交互状态

4.1 已安装APP状态

4.2 未安装APP状态

五、交互弹窗

5.1 唤起APP提示弹窗(iOS)

┌─────────────────────────────────────────────┐
│  即将打开“杜农农事通”APP                     │
│                                             │
│         [ 取消 ]    [ 打开 ]                │
└─────────────────────────────────────────────┘
(Universal Link 会自动触发系统弹窗,无需手动实现)

5.2 唤起失败引导弹窗(Android)

┌─────────────────────────────────────────────┐
│  ⚠️ 打开APP失败                             │
│  未检测到已安装的APP,请先下载              │
│                                             │
│         [ 下载APP ]    [ 取消 ]             │
└─────────────────────────────────────────────┘

六、端差异化说明

端唤醒方式检测已安装下载跳转
iOSUniversal Link系统自动App Store
AndroidURL Scheme超时检测应用宝 / 官方下载页
微信内置浏览器不支持直接唤起—引导用户点击右上角「在浏览器中打开」

七、页面交互说明(非核心交互,引导为主)

操作交互行为
点击「有用/没用」按钮弹出提示“请先打开APP”
点击「评论」按钮弹出提示“请先打开APP”
点击「收藏」按钮弹出提示“请先打开APP”
点击「转发」按钮弹出提示“请先打开APP”
点击「关注」按钮弹出提示“请先打开APP”
点击用户头像弹出提示“请先打开APP”
点击视频播放直接播放(H5原生播放器)

八、技术实现要点

模块实现方式备注
页面搭建移动端H5(Vue/React均可)响应式适配手机
视频播放H5 video标签 + 视频源支持MP4格式,H.264编码
数据获取后端API接口返回视频信息、用户信息、互动数据
Universal Link(iOS)后端配置apple-app-site-association文件已安装APP自动唤起
URL Scheme(Android)前端iframe方式尝试唤起配合超时检测判断安装状态
下载地址统一短链接后端根据UA自动301跳转对应商店

九、给开发的简要总结

  1. H5页面:能播放视频,展示视频信息及互动数据
  2. 非核心操作(有用、评论、收藏、关注、转发、头像):点击引导跳转APP
  3. 核心功能:检测是否安装APP,已装→打开APP,未装→引导下载
  4. 环境区分:微信内打开→引导右上角浏览器打开;浏览器打开→走正常唤起/下载逻辑
  5. iOS:Universal Link(最可靠)→ 系统自动弹窗,已装直接打开
  6. Android:URL Scheme尝试唤起 → 3秒超时 → 引导下载
  7. 统一下载页:https://dniscm.com/download/download.html