欢迎加入小米电视应用商店应用开发,与我们一起创造客厅娱乐的未来,在着手开发或者适配前,请确保您已经认真阅读《小米电视应用开发指南》,因为触犯上述条款中的任何内容将会导致您的应用无法通过审核,或者被我们进行下线处理。
一、开发者应用接入基本流程
1、注册账号,http://dev.xiaomi.com填写相关信息成为小米电视应用商店的开发者
2、合同流程,应用上架的相关合作请联系商务
小米电视应用商店商务联系人:蒲贝贝(pubeibei@xiaomi.com)、罗希娆(luoxirao@xiaomi.com)
3、提交应用
a)提交应用图标;
b)提交截图、视频(如有);
c)应用简介等应用周边信息填写;
d)应用渠道包。
4、应用审核
a)应用提交前,开发者需要根据《小米电视应用商店开发者测试规范》按需完成适配测试报告一并提交;
b)非节假日审核时间为1周,节假日顺延。
5、应用上架,应用审核完毕后,后台会出现【已通过】请在商店客户端查看。
6、应用下架,开发者发送应用下架申请邮件,人工审核通过后会将应用下架。
特别注意事项
您的应用必须在manifest中使用<uses-feature>将其定义为电视应用,这样才能在应用上传时被系统分类为电视应用,从而进入正确的审核流程,定义方法如下:
<uses-feature
android:name="android.hardware.type.television" android:required="true" >
</uses-feature>
参考:http://developer.android.com/guide/topics/manifest/uses-feature-element.html
二、概述
目前小米电视应用商店运行在MiBox和MiTV两大类设备上,目前主要型号包括MiBox1、MiBox Mini、MiBox3、MiBox4和MiTV1-4。主流的设备配置参数详见《小米电视&盒子设备规格参数》及http://www.mi.com 电视盒子分类
1. 选择目标设备
您可以自行选择您的应用所面向发行的小米电视平台设备种类,当然面向的设备种类越多,就意味着更高的潜在下载量。当您面向多种设备发行时,一个应用要同时支持您选择的所有目标设备,一定要确保您的应用可以在目标设备上正常显示,且所有目标设备上的显示保持一致,关于如何开发适配多种显示尺寸的应用请参考Supporting Multiple Screens。发布多个相同内容的应用分别支持不同目标设备的行为是不允许的,将导致您的应用无法通过审核。
如果您的应用是从安卓手机应用移植而来,我们强烈建议您参照Optimize your layouts for larger screens重新优化应用的UI已使其充分利用大尺寸显示的空间,给用户带来适合大屏设备的观看体验。如果您的应用已经适配了安卓平板电脑且符合谷歌的设计指导,它将更容易适配到小米电视平台。
2. 适配小米遥控器
小米电视平台标配的人机交互方式为小米遥控器,所有应用必须适配小米遥控器,也就是说使用小米遥控器可以浏览应用的所有内容,实现应用的所有功能。小米遥控器为小米电视平台设备通用,也就是说一个遥控器可以支持所有小米电视平台设备。除了小米遥控器之外,有线或无线的游戏手柄,鼠标,键盘等其他外设也是支持的,在适配小米遥控器的基础上,开发者可以自愿添加对于其他附件的支持,在此不予详述。下面是小米遥控器的键值。
按键 | 键值 | 说明 |
Power | KeyEvent.KEYCODE_POWER | 在任意画面按下后设备休眠,当前应用在前台暂停运行;设备唤醒后(依然通过power键),应用恢复运行,或者保持暂停状态由用户选择是否恢复(如播放器)。 |
Home | KeyEvent.KEYCODE_HOME | MiTV:功能与安卓标准Home键一致。在任意画面按下后切换到系统主页,当前应用切换到后台暂停运行,再次点击应用图标恢复运行;或者当前应用自动关闭。 MiBox1和MiBox1S:在任意画面按下后切换到系统主页,同时系统将当前应用自动关闭。 |
Back | KeyEvent.KEYCODE_BACK | 功能与安卓标准Back键一致。在应用主页按下后不得直接退出应用,应该给用户适当提示,由用户确认是否退出。 |
Menu | KeyEvent.KEYCODE_MENU | 功能与安卓标准Menu键一致。 |
Volume Down | KeyEvent.KEYCODE_VOLUME_DOWN | MiBox1的标配遥控器无此按键,在MiBox1上有声应用需要自行实现应用音量调节,无法实现的有声应用不能在MiBox1上发行。 |
Volume Up | KeyEvent.KEYCODE_VOLUME_UP | MiBox1的标配遥控器无此按键,在MiBox1上有声应用需要自行实现应用音量调节,无法实现的有声应用不能在MiBox1上发行。 |
Left | KeyEvent.KEYCODE_DPAD_LEFT | |
Right | KeyEvent.KEYCODE_DPAD_RIGHT | |
Up | KeyEvent.KEYCODE_DPAD_UP | |
Down | KeyEvent.KEYCODE_DPAD_DOWN | |
OK/Center | KeyEvent.KEYCODE_DPAD_CENTER/KeyEvent.KEYCODE_ENTER | 两个键值都要支持,以满足未来系统需求。 |
3. 广告要求
可以使用页内广告,广告内容必须与应用本身相关,禁止发布与应用无关的第三方广告。不要使用非页内广告。
4. 支付服务
由于TV应用商店已上线米币支付系统,不允许使用任何第三方支付平台以及虚拟货币,支付接入请联系相关商务:罗希娆、邮箱:luoxirao@xiaomi.com,签署合作协议获得小米TV应用商店开放平台提供的支付SDK接口文档和《小米电视应用商店测试规范_小米支付应用》。
实物支付方式建议:1. 实体商品货到付款。2. 通过扫描二维码在移动设备端完成支付。
5. 应用安装与调试
通过外部存储设备安装:将存放有目标apk的U盘或移动硬盘与小米电视或小米盒子连接(小米盒子可能需要OTG线),使用最新系统自带的高清播放器即可访问存储设备,安装apk;
通过adb命令安装调试(小米电视/盒子默认支持网络adb调试,打开adb方式同手机:设置 – 关于 – 产品型号,连续按键);
6. 版本号规范
版本号不能超过10位,建议版本号主要使用数字和“.”。除此规范之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的,例如应用说明,应用内信以及android manifest.xml内。
7. 应用图标规范
Ø 应用图标规范:
1)180*180图标直角,符合规范并打包进apk res文件夹下的xhdpi文件夹。
2)512*512图标直角,目标:在商店相关界面展示,不用打包进apk, 上传开发者后台即可。
符合《小米TV应用商店_icon-4K-visual-guide_v1.0》
以上两个图标要直角,系统会自动截取圆角。
3) 284*160图标圆角,非必选项,老应用需要遵守,
符合《小米TV应用商店_icon visual guide_v1.1》
Ø 推荐位图规范: