更新记录

0.1.6(2023-01-28)

  • 更新 云函数定时任务避免整点执行

0.1.5(2021-08-25)

  • 兼容vue3.0
  • 修复 iOS在搜索页面,失焦后无法聚焦

0.1.4(2021-03-01)

  • 调整为uni_modules目录规范
查看更多

平台兼容性

阿里云 腾讯云 支付宝云
Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue app-nvue × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

云函数类插件通用教程

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


什么是 uniCloud

uniCloud 是 DCloud 联合阿里云、腾讯云,为开发者提供的基于 serverless 模式和 js 编程的云开发平台,更多请参考uniCloud 文档

云端一体搜索模板解决了什么问题?

uniCloud 云端一体搜索模板,自带下拉候选、历史搜索、热搜。无需再开发服务器代码

云端一体搜索模板有以下功能点:

  • 热词设置,可自定义,回车默认搜索热词
  • 搜索历史,本地历史,去重排序删除
  • 搜索记录,自动向云端储存搜索记录,可用于归纳搜索发现
  • 搜索发现,向用户展现热搜
  • 搜索联想,基于 uni-list 实现搜索联想列表,兼容 nvue,高性能
  • APP 端语音输入,解放双手
  • 兼容 nvue

前后一体,兼容 nvue,只需导入插件,初始化数据库即可拥有上述功能。

您也可以自己修改逻辑自定义数据库字段,和随意定制 UI 样式。

体验步骤

  1. 下载或导入示例项目,绑定一个 uniCloud 服务空间。需 HBuilderX 3.0 以上版本。

  2. 在项目的 uniCloud/database 目录下找到 db_init.json,对其点右键执行初始化数据库。这样会给服务空间创建 3 个表:opendb-search-log、opendb-search-hot、opendb-mall-goods。如果之前存在相同表,建议删除后重新执行数据库初始化。

  3. 运行示例项目到任意平台,H5、App、小程序均可。

  4. 运行后首页是商品列表,上面有搜索框。点击搜索框进入搜索页面,输入待搜索的商品名称会在下方拉出候选,确认搜索后会返回商品列表页面,列表内容即为搜索结果。

  5. 在项目的 uniCloud/cloudfunctions 目录下找到云函数 uni-analyse-searchhot,点右键上传到服务空间,该云函数会定时运行,统计和计算近期热搜关键字,并体现在搜索界面的热搜候选词中。

项目代码说明

uniCloud 数据表

数据表基于 openDB 规范,它约定了一个标准用户表的表名和字段定义,并且基于 nosql 的特性,可以由开发者自行扩展字段。

本项目用到了 3 个表:

  • opendb-search-log:搜索日志表。每次搜索,都会将搜索词记录在该表中。详见
  • opendb-search-hot:热搜表。通过其他云函数定期分析搜索日志表,提取近期热搜词,存入热搜表。详见
  • opendb-mall-goods:用于本示例演示的商品列表。实际项目中,可自行提供为需要搜索的表。详见

这些表在 uniCloud Web 控制台中新建表的界面,均可以选择。

云函数

  • uni-analyse-searchhot
    • 这是一个定时运行的跑批云函数。用于从搜索日志表中归纳热搜。默认归纳最近7天搜索记录,截取其中10条,可在云函数中进行修改
    • package.json中有其触发器配置,默认每2小时运行一次,可在配置中修改。部署在云端后,也可以在 web 控制台修改。定时触发器使用cron 表达式
    • 注意 该云函数本地运行不生效,需要上传部署至云端

前端页面

首页是商品列表页面,点击顶部的搜索框,进入搜索页面。

前端页面基于 unicloud-db 组件操作数据库。

商品列表页面是基于 云端一体商品列表模板 改进而来。

页面示例搜索的是“opendb-mall-goods”表,可以在页面中的clientDB组件中修改collection属性,指向新的数据表进行搜索。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

云端一体搜索模板(以下简称软件)源码使用许可协议

2022年10月

本许可协议,是数字天堂(北京)网络技术有限公司(以下简称DCloud)对其所拥有著作权的“软件”,提供的使用许可协议。

您对“软件”的复制、使用、修改及分发受本许可协议的条款的约束,如您不接受本协议,则不能使用、复制、修改本软件。

授权许可范围

a) 授予您永久性的、全球性的、免费的、非独占的、不可撤销的本软件的源码使用许可,您可以使用这些源码制作自己的应用。

b) 您只能在DCloud产品体系内使用本软件及其源码。您不能将源码修改后运行在DCloud产品体系之外的环境,比如客户端脱离uni-app,或服务端脱离uniCloud(如涉及uniCloud)。

c) DCloud未向您授权商标使用许可。您在根据本软件源码制作自己的应用时,需以自己的名义发布软件,而不是以DCloud名义发布。

d) 本协议不构成代理关系。

DCloud的责任限制 “软件”在提供时不带任何明示或默示的担保。在任何情况下,DCloud不对任何人因使用“软件”而引发的任何直接或间接损失承担责任,不论因何种原因导致或者基于何种法律理论,即使其曾被建议有此种损失的可能性。

您的责任限制

a) 您需要在授权许可范围内使用软件。

b) 您在分发自己的应用时,不得侵犯DCloud商标和名誉权利。

c) 您不得进行破解、反编译、套壳等侵害DCloud知识产权的行为。您不得利用DCloud系统漏洞谋利或侵害DCloud利益,如您发现DCloud系统漏洞应第一时间通知DCloud。您不得进行攻击DCloud的服务器、网络等妨碍DCloud运营的行为。未经书面许可,您不得利用DCloud的产品进行与DCloud争夺开发者的行为。

d) 如您违反本许可协议,需承担因此给DCloud造成的损失。

本协议签订地点为中华人民共和国北京市海淀区。

根据发展,DCloud可能会对本协议进行修改。修改时,DCloud会在产品或者网页中显著的位置发布相关信息以便及时通知到用户。如果您选择继续使用本框架,即表示您同意接受这些修改。

条款结束

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问