Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hi-our/hi-face
Hi头像——让头像有趣一点。
https://github.com/hi-our/hi-face
Last synced: about 1 month ago
JSON representation
Hi头像——让头像有趣一点。
- Host: GitHub
- URL: https://github.com/hi-our/hi-face
- Owner: hi-our
- License: mit
- Created: 2020-01-28T07:53:07.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-05T12:12:56.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T19:33:01.068Z (4 months ago)
- Language: JavaScript
- Homepage: https://www.xiaoxili.com/hi-face
- Size: 23.1 MB
- Stars: 332
- Watchers: 8
- Forks: 64
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-github-star - hi-face - our | 329 | (JavaScript)
- awesome-taro - Hi头像 - face) (开源项目 / Taro2)
README
# Hi头像
让头像有趣一点
## 功能体验
小程序二维码
Web 体验版：[https://face.xiaoxili.com](https://face.xiaoxili.com)
**DEMO 体验版**
前台功能：https://face-demo.xiaoxili.com
CMS 数据体验：https://face-demo.xiaoxili.com/tcb-cms/
账号： cmsAdmin
密码： cmsAdmin123==
如有问题，可以提 Issue
请勿修改密码，上传敏感数据。环境数据可能会被清空，勿做私人使用。
## 愿景
### 使用场景&目标用户&背景
在节日的时候，我们可以使用符合节日七夕的头像，比如在国庆节使用含国旗的头像表达对祖国的祝福；在圣诞节的时候，我们能给亲朋送一个带圣诞帽的头像传递快乐。
### 需求分析
在一些特定节日里，很多人尤其是年轻人喜欢新潮的头像，比如近几年的圣诞节，会有“@官方微信，送我一顶圣诞帽“的需求，对此，我们做这个小程序，来解决特定时候头像的制作。
### 设计理念
**标语：让头像有趣一点**
「Hi头像」结合节日特点，微信头像进行智能化处理，让头像更加符合节日氛围。
1、紧跟节日热点
国庆节头戴国旗、圣诞节智能戴帽子，增加节日乐趣
2、简单易操作
不同于各类app的繁琐，小程序更简洁易操作
3、乐于分享
借助微信社交机制，头像处理后可以分享给好友或分享到朋友圈，展示头像成果
### 用户画像
20-35喜欢分享的年轻人
### 作品效果图
### 产品介绍视频
[Hi头像小程序介绍视频-完整版](https://v.qq.com/x/page/l3152qjx9e8.html)
## 主创人员
**小溪里，技术研发**
个人网站：[https://www.xiaoxili.com](https://www.xiaoxili.com)
公众号：小溪里
**不二雪，UI设计**
公众号：不二诗旅
## 技术栈
* ❤️ UI侧 —— Taro，文档见 https://taro.jd.com/
* ❤️ 服务 —— 云开发 CloudBase，文档见 https://docs.cloudbase.net/
* ❤️ 部署 —— 基于 CloudBase Framework 完成小程序端、Web端、云函数、数据模型构建，官网见 https://cloudbase.net/framework.html
* ❤️ 内容管理 —— 基于 CloudBase CMS 管理数据，文档见 https://docs.cloudbase.net/cms/intro.html
## 部署文档
本项目的部署文档非常详细，详情请查看《[DEPLOYMENT](https://github.com/hi-our/hi-face/blob/master/DEPLOYMENT.md)》文档。
## RoadMap
🚀 表示已经实现的功能，👷 表示进行中的功能，⏳ 表示规划中的功能，🏹 表示技术方案设计中的功能。
| 功能 | 状态 | 发布版本 |
| -------------------------------------------------------- | --------- | -------- |
| UI 重构、页面流程优化 | 🚀 已实现 | V2.0 |
| 云函数合并，使用 `tcb-router` 进行路由匹配 | 🚀 已实现 | V2.0 |
| 云函数优化，封装更完毕的错误处理信息 | ⏳ 规划中 | V3.0 |
| 使用 `cloudbase-framework` 来发布 Web 端、云函数 | 🚀 已实现 | V2.0 |
| 使用 `cloudbase-framework` 来部署小程序的预览、体验版 | 🚀 已实现 | V2.0 |
| `Cloudbase CMS v1` 版数据模型快速生成集合字段 | 🚀 已实现 | V2.0 |
| `Cloudbase CMS v2` 版数据模型快速生成集合字段及提供默认数据 | ⏳ 已实现 | V2.0 |
| 贴纸编辑器调研 | 🏹 设计中 | V3.0 |
| 小程序冷启动数据预加载 | 🏹 设计中 | V3.0 |
| 海报换为 `canvas 2d` 版 | 🏹 设计中 | V3.0 |
| Web 版云开发登录鉴权设计 | 🏹 设计中 | V3.0 |
| 云环境共享调研 | 🏹 设计中 | V3.0 |
| 更多的腾讯云人工智能服务 | 🏹 设计中 | V3.0 |
## 贡献榜
阅读我们的贡献指南，让我们一起建立一个更好的头像小程序。
我们欢迎所有贡献。 请先阅读我们的 《[CONTRIBUTING.md](https://github.com/hi-our/hi-face/blob/master/https://github.com/hi-our/hi-face/blob/master/CONTRIBUTING.md.md)》。 您可以提交任何想法到[pull requests ](https://github.com/hi-our/hi-face/pulls)或[ GitHub issues](https://github.com/hi-our/hi-face/issues)。 如果您想改善代码，请查阅《[DEPLOYMENT](https://github.com/hi-our/hi-face/blob/master/DEPLOYMENT.md)》文档，祝您玩得愉快！ :)
## 特别鸣谢
从 v1到v2版迭代过程中，有4位同学参与了一些工作。
* [王宝国](https://github.com/wangbaoguo88)：产品助理，撰写了 v1.0 的产品文档
* [李欢](https://github.com/huan-x)：开发助理，编写了 v1.x 中原生小程序的人像魅力、图片标签等页面
* [任乐乐](https://github.com/wolf-lang)、[康鸿](https://github.com/daxiakang)：协助 v2.0 版的功能测试
* [忍者无敌](https://github.com/LoserTeach)：协助 v2.0 部署文档内容的补充
若想贡献代码或者提供建议，请先查阅《[CONTRIBUTING](https://github.com/hi-our/hi-face/blob/master/https://github.com/hi-our/hi-face/blob/master/CONTRIBUTING.md.md)》文档。
## 开发交流
[官方交流微信群](https://github.com/hi-our/hi-face/issues/43)
## 更新记录
本项目遵从[Angular Style Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153)，更新日志请查阅 《[CHANGELOG](https://github.com/hi-our/hi-face/blob/master/https://github.com/hi-our/hi-face/blob/master/CHANGELOG.md.md)》
## 学习资源
《**[从0到1开发一个智能头像识别小程序](https://www.xiaoxili.com/hi-face/docs/README.html)**》
>本技术小册基于Hi 头像 v1版本编写，v2 版本正在撰写中。
从产品功能规划、技术选型到实战开发，全方位介绍基于小程序云开发来实现智能人像识别小程序，不仅能完成跨端开发，更能学习到当今炙手可热的 ServerLess 开发实战（即小程序与 Web 云开发），更能将高深的人工智能技术落地到真实项目中，甚至，我们还将探索如何将小程序与Web端完成前端工程化实践。
**你会学到什么？**
* 小程序云开发配置与开发技巧，亲历云开发的实战场景
* 基于 tcb-router 封装多功能的 API 服务
* 基于静态网站托管部署 Web 版
* 基于 CMS 内容管理系统来统一管理数据
* 基于 Cloudbase-Framework 来部署云函数、小程序和 Web 端
* 体验及实战腾讯云人工智能特色功能，如人脸识别、五官分析、人像转换等
* Taro 跨端使用技巧，在实战中了解Canvas在小程序与web端的差异，以及图片裁剪、压缩、上传的各种技术细节
* 产品需求、项目规划的实战知识
## 项目综述
本项目在小程序和Web端使用 Taro 构建，功能服务基于[腾讯云云开发](https://www.cloudbase.net/)及腾讯云人工智能服务，使用 CMS 内容管理系统来管理数据，基于[Cloudbase Framework](https://github.com/TencentCloudBase/cloudbase-framework)完成小程序端、Web端、云函数端构建。
## 架构图
### 整体关系图
### 页面间调用关系图
在`taro/src`中，有以下文件
```
|-config.js 配置AppId、云环境Id及其它
|-components 全局组件
|-pages
|-|- avatar-edit 头像编辑页
|-|- avatar-poster 头像分享页
|-|- theme-list 主题列表
|-|- self 我的，含个人头像列表
```
### 头像编辑页流程图
头像编辑是Hi 头像的主逻辑，下面这个流程图充分展示了从加载主题数据、到头像编辑、再到头像生成的完整流程。
Hi 头像功能以小程序端为主，功能齐全，而在 web端能制作头像并保存图片，暂不提供头像保存和分享功能。
### 五官分析时序图
v1版中使用图示“第五版”时序图来完成主逻辑，而v2版中使用“第六版”时序图，这两者差异点就是基于已有服务来完成功能，更容易初学者掌握。
### 核心语法
1、云函数`hiface-api`基于`tcb-router`做路由跳转
主要功能有头像、主题、用户信息的获取与更新，还有创建小程序码的功能。
路径为`cloud/functions/hiface-api`
2、核心算法
基于五官分析为多个人脸戴上贴纸，具体可以查看《[通过五官分析实现为人脸佩戴贴纸](https://www.xiaoxili.com/hi-face/docs/4-development/3-analyze-face-shape.html)》
## License
* 前后端技术源码为 MIT License
* 页面UI设计版权为作者不二雪所有，如玫红色UI、含小象logo的背景图等
* 节日主题及贴纸来源为 iconfont，版权归原作者所有
* 依据 Hi 头像完整功能进行上线时，请在页脚备注“技术支持来自小溪里”
Copyright (c) 2020 Hanqin