视频播放功能屏蔽说明

屏蔽日期: 2026-03-13 屏蔽原因: 个人主体小程序不支持视频服务类目 审核反馈: "你的小程序涉及视频服务，属个人主体小程序未开放类目"

---

📋 功能概述

功能名称: 视频播放器 技术实现: 原生 video 组件 + 独立播放页面 触发场景: 用户点击资料库中的视频文件

---

🔍 原实现方式

1. 视频播放页面

文件: src/pages/video-player/index.vue

• 使用 Taro video 组件
• 支持全屏播放、进度控制、音量控制
• 支持的格式：MP4、M4V、MOV

2. 跳转逻辑

文件: src/composables/useFileOperation.js:378-393

// 原代码（已屏蔽）
if (isVideoFile(item)) {
  await Taro.navigateTo({
    url: `/pages/video-player/index?url=${encodeURIComponent(item.downloadUrl)}&title=${encodeURIComponent(item.title || item.fileName)}`
  })
  return true
}

3. 路由配置

文件: src/app.config.js

// 原配置（已注释）
const pages = [
  // ...
  'pages/video-player/index',
  // ...
]

---

🚫 屏蔽后的行为

当前实现

文件: src/composables/useFileOperation.js:378-394

if (isVideoFile(item)) {
  // 视频文件：已屏蔽跳转功能（个人主体小程序限制）
  console.log('[文件操作] 视频文件预览已屏蔽（个人主体限制）:', item.fileName)
  showToast({
    title: '小程序暂不支持视频预览',
    icon: 'none',
    duration: 2000
  })
  return false
}

用户体验

• 点击视频文件时，显示提示："小程序暂不支持视频预览"
• 不会跳转到播放页面
• 不会触发视频播放

---

✅ 恢复方法（企业主体）

当小程序升级为企业主体后，按以下步骤恢复功能：

步骤 1: 恢复路由配置

文件: src/app.config.js

const pages = [
  // ...
  'pages/message/index',
  'pages/message-detail/index',
  'pages/video-player/index', // ✅ 取消注释
  'pages/article-detail/index',
]

步骤 2: 恢复跳转逻辑

文件: src/composables/useFileOperation.js

// 判断是否为视频文件（优先使用 extension 字段）
if (isVideoFile(item)) {
  // 视频文件：跳转到视频播放页面
  try {
    await Taro.navigateTo({
      url: `/pages/video-player/index?url=${encodeURIComponent(item.downloadUrl)}&title=${encodeURIComponent(item.title || item.fileName)}`
    })
    return true
  } catch (error) {
    console.error('[文件操作] 视频打开失败:', error)
    showToast({
      title: '视频打开失败',
      icon: 'none',
      duration: 2000
    })
    return false
  }
}

步骤 3: 删除屏蔽提示

删除 useFileOperation.js 中的屏蔽提示代码：

// 删除以下内容
showToast({
  title: '小程序暂不支持视频预览',
  icon: 'none',
  duration: 2000
})

步骤 4: 重新编译

pnpm build:weapp

---

📝 相关文件清单

文件	状态	说明
src/pages/video-player/index.vue	保留	视频播放页面组件
src/pages/video-player/index.config.js	保留	页面配置
src/composables/useFileOperation.js	已修改	屏蔽视频跳转逻辑
src/app.config.js	已修改	注释路由配置

注意: 所有源代码文件均保留，仅修改调用逻辑，便于后续恢复。

---

🔗 相关资源

• 微信小程序个人主体限制
• 小程序服务类目
• 恢复总览

---

📅 变更日志

日期	操作	说明
2026-03-13	屏蔽	个人主体审核不通过
-	-	待恢复（升级企业主体后）