# API **Repository Path**: wuhuijing/API ## Basic Information - **Project Name**: API - **Description**: API期末项目 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-07-03 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # API | 文档名称 | 智能e家—产品需求文档 | |------|------------------------------------------------------------| | 产品名称 | 智能e家 | | 产品描述 | 一款帮助主人更好管理家居，实现人类零参与，高效管理家居的系统，此款系统有别于市场现存的智能家居APP及家庭操作系统。 | | 产品版本 | 1.0 | | 文件现状 | 进行中 | | 文件作者 | 吴慧晶 | **价值宣言** 我认为针对特殊状况状况对家居电器门窗进行智能化控制的智能应用还没有在市场上出现，而智能e家就是针对该漏洞对现有的智能家居类APP和家居系统进行整合并加值优化。其中该APP使用到的人工智能技术有天气查询API、IP定位API、交通态势API等，这些技术的综合运用能有效满足现代人对家居管理的需求以及解决大部分人在管理家居时空间和时间上的痛点。 ## 一、需求概述 1. 产品背景 随着生活节奏的加快，人们更多的时间都花在拼搏和忙碌的过程中，而在家的时间越来越少，分出时间和精力去管理家居也变得困难。对于这些独居人群来说，他们渴望能有一个人帮他们分担管理家居事务，因此智能家居APP或者是家居系统就成为他们的首选项。但现今市场上已经出现的智能家居APP和家居系统，还都需要人为操控，还没有实现真正的智能和完全托管化。 2. 产品市场 经过比对几家智能家居app和家居系统发现，想要实现家居智能管理并不难，但是希望为独居、生活节奏快的群体作为核心用户的APP或者是系统非常少。此外，随着人工智能的发展，事实上普通的智能家居APP或系统已经能满足大部分人的需求，但是，对于独居生活节奏快的任人群，他们需要一个更加智能化的产品帮助他们高效管理家居，而此类更加智能化的家居产品还处在起步阶段。 3. 市场概述 3.1 全球智能家居类产品的市场概述 “2018－2022年全球智能家居市场分析：报告显示，2018年全球智能家居包括设备，系统和服务消费支出总额将接近960亿美元，且在未来5年的（2018－2023年）年复合增长率为10％，到2023年将增长至1550亿美元。”——[《2018年全球智能家居市场预测》](http://www.qianjia.com/html/2018-08/15_301906.html) 从目前的来看，几乎每个国家的智能家居产业在未来几年都有快速上涨的趋势，且更多的用户愿意为提高生活质量节约时间成本而为智能家居花钱。从智能家居市场的用户年龄看，在25-34岁之间的消费者占消费者人群的比重高。智能家居的市场前景很好，但目前该产业也还在摸索前进的阶段。 3.2 市场特征 - 智能家居市场广阔，发展迅速，目前仍处在发展时期。 - 智能家居更智能化的产品还未出现，针对独居、生活节奏人群的隐形托管化的产品目前还未有，发展空间广阔。 - 对产品技术要求较高，需要根据特殊场景做出特殊的应对措施。 3.3 发展优势 - 可以为独居、生活节奏快人群解决问题，会受此类人群的欢迎。 - 适应智能化时代发展的需求，市场广阔，开发潜力大，具有开发价值。 - 目前市场已出现相关产品，可以借鉴学习。 ## 二、核心价值（最小可行性产品） 着眼于解决独居、生活节奏快人群管理家居的问题，智能e家将为此类用户提供更具智能化的家居管理服务。 **用户痛点：** 1. 出门后天气状况突然发生改变，无法回家改变家居状态。 2. 离家时，忘记切掉某处的开关或者电源，出现无法弥补的严重后果。 3. 想在回家后直接享受家居服务，而不需要花时间等待。 ## 三、用户分析 1. 目标用户群 - 核心用户：22—35岁的独居生活节奏快的群体 - 主要用户：各个年龄段需要智能家居辅助管理的群体 2. 用户画像及使用场景 ![小琪的用户画像](https://gitee.com/wuhuijing/API/raw/master/PRD%20images/%E7%99%BD%E9%A2%86%E7%94%A8%E6%88%B7%E7%94%BB%E5%83%8F.png "在这里输入图片标题") 使用场景：小琪安装了智能e家系统后，系统根据特殊场景的天气预测帮小琪预测出下雨的时间。某天小琪出门后突然又始下雨，正在小琪抱怨天气时，手机收到了智能e家向她发出的提醒短信“已为您关闭所有门窗电器，请小主在外注意安全，小e为您守护！”并附上一张家里摄像头捕捉到的家里现状的画面。 ![小源的用户画像](https://gitee.com/wuhuijing/API/raw/master/PRD%20images/%E5%8D%95%E8%BA%AB%E6%AF%8D%E4%BA%B2%E7%94%BB%E5%83%8F%20(1).png "在这里输入图片标题") 使用场景：小源出门买菜后发现家里的煤气管道忘记关了，而且自己孩子还在家里！事实上，智能e家在识别到家里的大人出门后就已经关掉了煤气管道的闸门，并检测到室内有含量过高的一氧化碳，及时开启家里的较高的窗户和排气扇去除一氧化碳气体。并且摄像头定时向小源发送家里小孩的照片，确保小孩在家安全无恙。 ## 四、核心价值与用户痛点 | 用户痛点 | API加值 | |----------------------|---------------------| | 天气突变时没法及时回家关闭门窗家电 | 高德开放平台中的天气查询API | | 家里有年老弱残者无法及时监察他们的情况 | 百度AI平台中的活体检测API | | 回到家后无法及时享受家居给他们带来的服务 | 高德开放平台的IP定位和交通态势API | ## 五、人工智能概率性与用户痛点 高德开放平台的天气查询、IP定位、交通态势检测等技术与百度AI开放平台的人脸识别中的活体检测，有以下优势： | 高德开放平台的天气查询、IP定位、交通态势检测等技术/用户痛点 | 人脸识别中的活体检测/用户痛点 | |-----------------------------------------------------------|---------------------------------------------------------------------------------| | 1.天气查询：查询当地的天气状况，准确率较高——保证用户家中的系统在预测识别天气状况后准确做出反应 | 1. 准确性：配合SDK 完成眨眼、张嘴、摇头、左右转头、上下点头等7种预设动作，随机抓取多图进行活体判断，可自定义生效动作及校验顺序——准确抓取活体状态 | | 2. IP定位：与用户绑定的手机相关联，定位手机IP的位置——定位当前主人的所在位置 | 2. 即时性：现场录制视频，读出随机分配的数字，确保视频的即时性，而非事先录制，上传视频到云端进行活体分析，提升抵御攻击的能力——查看家里弱势群体的实时状态 | | 3.交通态势：根据用户IP所在位置内容返回查询到的相关交通态势情况。——预测主人到家的时间，并提前一定时间开启电器 | 3. 场景特殊性：利用近红外成像原理，实现夜间或无自然光条件下的活体判断，在屏幕无法成像、材质反射率不同等情况下维持高鲁棒性——家里环境较暗时也能捕捉活体信息 | 因此，该产品利用天气查询功能对所在地天气状况进行预测，系统根据预测结果对家居开关进行控制，但是天气状况的预测准确率与当地的地理环境等因素有关，所以预测结果的准确率不会达到100%；IP定位于交通态势的结合来预测主人到家时间也受多方因素的影响，但只要不出现特殊情况，对主人到家时间的预判波动不会太大；这些问题的出现概率较小，在大部分情况下，这些API都能相互协作为用户提供更好的服务。 **识别不准确的方法：多方因素共同作用导致事件具有不确定性 ** ## 六、需求列表（对应人工智能加值） | 序号 | api技术 | 用户场景 | 优先级 | |----|--------------|---------------------------|--------| | 1 | 高德开放平台IP定位 | 定位主人所在位置 | A（重要） | | 2 | 高德开放平台交通态势 | 根据IP定位查看主人周围的交通态势，并预测到家时间 | A（重要） | | 3 | 高德开放平台天气查询 | 查询未来或当前天气，系统根据天气结果控制家电开关 | A（重要） | | 4 | 百度AI开放平台活体检测 | 检测家中老弱病残者的实时状态 | B（次重要） | ## 七、产品结构图 1. 产品功能结构图 ![产品功能结构图](https://gitee.com/wuhuijing/API/raw/master/PRD%20images/%E6%99%BA%E8%83%BDe%E5%AE%B6.png "在这里输入图片标题") 2. 用户流程图 ![用户流程图](https://gitee.com/wuhuijing/API/raw/master/PRD%20images/%E6%99%BA%E8%83%BDe%E5%AE%B6%E7%94%A8%E6%88%B7%E6%B5%81%E7%A8%8B%E5%9B%BE.png "在这里输入图片标题") 3. 产品结构图 ![产品结构图](https://gitee.com/wuhuijing/API/raw/master/PRD%20images/%E4%BA%A7%E5%93%81%E7%BB%93%E6%9E%84%E5%9B%BE.png "在这里输入图片标题") ## 八、数据推理 | 问题/回答 | 内容 | |-------|-------------------------------------| | 问题1 | 我们在页面上呈现什么内容 | | 回答1 | 天气查询结果；IP定位以及IP附近的交通态势，主要以图片形式呈现 | | 问题2 | 向用户输出的结果内容从哪里来 | | 回答2 | 去开放平台调用api，获得结果内容 | | 问题3 | 请求从哪里来 | | 回答3 | 定位，手机IP 定位， 摄像头捕捉的画面 | | 问题4 | 如果页面出现识别错误，应该如何获取并处理数据，正确数据的信息从哪里来 | | 回答4 | 通过用户的反馈进行信息获取，通过用户的自愿反馈扩大数据库，强化机器学习 | ## 九、产品原型机交互设计 - 原型文档下载区 - 原型文档交互展示 - 原型文档rp文件下载区 1. 核心页面 2. 主要页面 ## 十、API的运用 （一）天气查询 高德开放平台（天气查询） 接口描述：该请求用于天气查询。即根据当地的地理编码输出未来或者当前天气状况。 接口地址：https://restapi.amap.com/v3/weather/weatherInfo?parameters 请求方法：GET 输入与输出的源代码链接 （二）IP定位、交通态势 高德开放平台（IP定位、交通态势） 接口描述：根据用户输入的IP地址，能够快速的帮用户定位IP的所在位置。 接口地址：ip：https://restapi.amap.com/v3/ip?parameters 请求方法：GET 输入与输出的源代码链接 （三）活体检测 百度AI平台（活体检测） 接口描述：基于单张图片，判断图片中的人脸是否为二次翻拍，以及是否为合成图攻击。此能力可用于H5场景下的一些人脸采集场景中，增加人脸注册的安全性和真实性。 接口地址：https://aip.baidubce.com/rest/2.0/face/v1/merge 请求方法：GET 输入与输出的源代码链接 ## 十一、API使用风险评估 **错误现象及处理办法：** 1. 天气状况的预测准确率与当地的地理环境等因素有关，所以预测结果的准确率不会达到100%； 2. IP定位于交通态势的结合来预测主人到家时间也受多方因素的影响。 3. 活体检测可能会受摄像头捕捉的画面的像素的影响，从而影响活体检测的正常识别。