更新记录

1.0.1（2026-08-07）

发版

1.0.0（2026-08-07）

发版

平台兼容性

云端兼容性

uni-app(5.14)

uni-app x(5.14)

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

星光冥想

星光冥想是一款基于 UniApp 与 uniCloud 开发的冥想助眠应用，提供冥想课程、白噪声、音频播放、播放记录和会员订阅等功能。项目采用 Vue 3，当前版本为 1.0.0，主要面向 Android App 运行和发行。

核心功能

• 推荐内容：在发现页展示精选冥想与助眠内容。
• 冥想课程：按场景和主题浏览冥想分类及课程。
• 白噪声：提供自然声、环境声等助眠音频分类。
• 音频播放：支持播放控制、播放模式切换和播放列表。
• 个人中心：展示会员状态，并提供订阅、恢复购买和订阅管理入口。
• 云端能力：通过 mingxingapi 云函数处理用户、内容和订阅状态等业务。
• Google Play 订阅：Android App 支持月度、年度订阅商品接入。

应用截图

技术栈

• UniApp
• Vue 3
• uniCloud（阿里云）
• HBuilderX
• Google Play Billing（Android 订阅）

项目结构

mingxiang/
├── api/                         # 前端接口封装
├── components/                  # 公共组件
├── pages/
│   ├── index/                   # 发现、分类与推荐内容
│   ├── play/                    # 音频播放页
│   └── mine/                    # 个人中心与会员订阅
├── static/                      # 图片、图标等静态资源
├── uniCloud-aliyun/
│   ├── cloudfunctions/
│   │   ├── common/              # 云函数公共模块
│   │   └── mingxingapi/         # 项目业务云函数
│   └── database/                # 云数据库相关文件
├── manifest.json                # 应用及原生模块配置
├── pages.json                   # 页面与底部导航配置
└── package.json                 # 插件市场项目描述

开发运行

本项目为 HBuilderX 工程，不是常规的 Vite/npm CLI 项目。

1. 安装并打开 HBuilderX，选择“文件 > 导入 > 从本地目录导入”。
2. 导入项目根目录，并确认项目使用 Vue 3 编译。
3. 在 HBuilderX 中登录 DCloud 用户。
4. 关联一个 uniCloud 阿里云服务空间。
5. 上传公共模块和 mingxingapi 云函数后，选择目标平台运行项目。

配置 uniCloud

1. 在项目上右键，选择“创建 uniCloud 云开发环境”或关联已有的阿里云服务空间。
2. 在 uniCloud-aliyun/cloudfunctions/common 下分别上传公共模块。
3. 在 uniCloud-aliyun/cloudfunctions/mingxingapi 上右键，选择“上传部署”。
4. 根据实际业务准备云数据库数据，并在部署环境中补充所需配置。

云函数依赖以 uniCloud-aliyun/cloudfunctions/mingxingapi/package.json 为准。首次部署或依赖变化后，需要重新上传并部署云函数。

Google Play 订阅

订阅功能仅在 Android App 安装包中可用。正式打包前需要完成以下配置：

1. 在 Google Play Console 中创建订阅商品，并保证商品 ID 与 pages/mine/mine.vue 中的配置一致：
   • 月度会员：mingxiang_monthly
   • 年度会员：mingxiang_yearly
2. 在 HBuilderX 的 App 模块配置中启用支付能力，并为云打包接入可用的 Google Play Billing/Google 支付插件。
3. 使用与 Play Console 一致的应用包名、签名证书和测试用户生成 Android 安装包。
4. 在 Google Play 测试轨道安装应用，验证购买、续订、恢复购买及服务端订阅状态校验。

manifest.json 已声明 com.android.vending.BILLING 权限，但权限声明本身不等于完成支付接入。正式上线时还应在服务端校验 purchaseToken，不要只依赖客户端保存的订阅状态。

构建发行

在 HBuilderX 中选择“发行 > 原生 App-云打包”，完成 Android 应用包名、证书、原生支付插件及隐私权限配置后进行构建。提交 Google Play 前，请使用内部测试或封闭测试轨道完成真实订阅流程验证。

说明

• 应用名称：星光冥想
• 当前版本：1.0.0
• 云函数名称：mingxingapi
• 底部导航：发现、播放、我的

👉︎👉︎👉︎ 咨询客服 👈︎👈︎👈︎

Vibe coding 软件开发：出售多种网赚项目和软件开发(点击前往查看详情)

扫码体验