小米开放平台MIUI小部件规范一-APP开发

小米开放平台MIUI小部件规范

1.小部件简介

小部件是Android提供的能力。开发者可选取应用中重要的内容直接在桌面或小部件屏中呈现给用户，以提升用户在桌面获取信息与直达服务的效率。同时用户可通过小部件实现个性化桌面。

2.MIUI小部件体系

MIUI小部件体系基于Android小部件，对设计与技术实现进行了规范，并持续迭代开发者所需要的能力，从而联合开发者一起为用户提供更好的使用体验。

2.1.桌面网格

通过对桌面的重新设计，MIUI支持小部件在手机桌面中优雅的展示，用户可以非常方便的将小部件添加至桌面，并可快速拖动至小部件屏。

同时还支持“无字模式”：隐藏桌面上的应用与小部件名称，使桌面的简约美感达到极致。（操作路径：桌面双指捏合—左下角设置图标—无字模式）

2.2.小部件屏

原MIUI智能助理升级为小部件屏，承载了用户统一查看并使用小部件的需求。用户可以根据自己的使用习惯和喜好，对小部件进行自定义排序。

3.3.小部件中心

当用户需要添加小部件时，可以很方便的从桌面或小部件屏中，找到小部件中心入口。小部件中心支持用户直接拖拽小部件至桌面或小部件屏。

除此之外，用户还可以在这里发现更多好看或好用的小部件，即使用户未安装对应的应用。若用户未安装应用，在小部件中心中将展示开发者上传的小部件名称与截图，以此向用户传达该小部件的价值，吸引用户添加。用户添加后，将先下载该应用，安装完成后添加对应小部件。

同时，小部件中心也支持安卓小部件的入口，用户可以通过“支持小部件应用-全部-安卓小部件”入口添加。

3.小部件产品规范

3.1.小部件的名称与介绍

开发者可以根据每个小部件的功能，为小部件撰写一个简洁的名称（2~10个汉字）。在小部件中心里，小部件名称会展示为“应用名称·小部件名称”，为了展示体验更佳，小部件名称与应用名称不得相同。

为了更好的帮助用户理解小部件的用途，开发者还需要为每个小部件撰写介绍。小部件介绍的中文长度不得超过22个中文字符，其他语言长度不超过44个中文字符（1个中文字符 = 2个特殊字符 / 2个非中文字符）。

3.2.小部件的尺寸

MIUI小部件支持2*2、4*2、4*4三种尺寸，开发者可以根据小部件信息和所需展示的功能选择合适的尺寸进行设计。

3.3.如何设计一个小部件

小部件中展示的内容由开发者定义，在开发者设计小部件时，我们建议遵循以下原则：

仅展示重点信息：小部件可便捷展示简洁的信息，建议开发者选择一个与您的应用主要用途相关的功能或内容。如运动应用的小部件展示今日步数、音乐应用的小部件展示最近播放的歌曲等；

与个人内容相关：当小部件与用户个人信息有关时，更容易被用户添加并使用。如日历应用在展示月视图的同时展现我的日程、电商应用的小部件展示用户最新物流信息、电影购票应用展示用户即将开场的电影票信息。

根据尺寸填充不同内容：小部件中展示的信息量应该根据尺寸进行变化，如2*2的天气小部件仅展示当前温度，4*2的天气小部件可展示最近几小时的温度走势，4*4的天气小部件可展示未来多天的天气预报。

避免仅跳转应用首页：小部件应该为用户提供信息外露或功能直达的价值，如果点击一个小部件仅仅是打开应用首页，大部分用户将不会添加到其桌面上。
具有品牌辨识度：为了让用户能知道小部件所展示的内容来自哪个应用，建议在设计小部件时加入品牌元素，但不建议直接放APP的图标在小部件中。
（建议适配项）支持深色模式：小部件需要支持深色模式，在用户进入深色模式后，可以通过修改前景与背景颜色，使小部件与深色模式下的系统更加统一。如小部件未适配深色模式，也要保证在系统切换为深色模式后，小部件的显示和功能正常。
（建议适配项）支持无障碍：MIUI一直致力于让全球每一个人都能享受科技带来的美好生活，因此我们建议开发者设计的小部件，也支持无障碍功能，了解更多可前往小米无障碍官网（http://accessibility.miui.com/）。如小部件未适配无障碍，也要保证在系统开启无障碍talkback功能或是在“设置-无障碍-视觉”中将字体调大后，小部件的显示和功能正常，未出现截断或遮挡等异常现象。
（建议适配项）支持多语言：MIUI已经拥有国内外3.1亿用户，覆盖80种语言，支持221个国家与地区。在MIUI国内版中，建议开发者设计的小部件，跟随主应用适配简体中文、繁体中文、英文、维语、藏语中的全部或部分语言，并保证在系统切换为多语言后，小部件的显示和功能正常，未出现截断或遮挡等异常现象。