小米应用开发者文档

原文地址：http://dev.xiaomi.com/doc/?p=2212

电视/盒子应用开发指南

欢迎加入小米电视应用开发，与我们一起创造客厅娱乐的未来，在着手开发或者适配前，请确保您已经认真阅读《小米应用商店应用审核指南》，因为触犯上述条款中的任何内容将会导致您的应用无法通过审核，或者被我们进行下线处理。

特别注意事项

您的应用必须在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

概述

目前小米电视应用商店运行在MiBox1，MiBox1S和MiTV上，也就是说小米电视应用商店上的应用程序是暂时面向以上三款设备发行的，当然随着小米电视平台新产品的推出，应用商店的应用将会面向更多的设备。下面是目前三款设备的配置参数：

项目	MiBox1	MiBox1S	MiTV
屏幕尺寸 扫描二维码关注公众号，回复： 11588582 查看本文章	/	/	47英寸(LG)/48英寸(三星)
分辨率	1280*720	1280*720	1920*1080
CPU	Cortex-A9	Cortex-A9	高通骁龙 600 MPQ8064
	800MHz	双核1.5GHz	四核1.7GHz
GPU	Mali-400	Mali-400 双核	Adreno320
内存	1024MB	1024MB	2048MB
WiFi	2.4GHz	2.4GHz/5GHz	2.4GHz/5GHz
	802.11a/b/g/n	802.11a/b/g/n	802.11a/b/g/n 2x2MIMO
蓝牙	/	BT4.0	BT4.0
3D成像	偏振式(需外接设备支持)	偏振式(需外接设备支持)	偏振式
系统版本	Android 4.1.2	Android 4.2.2	Android 4.1.2
系统存储	4GB	4GB	8GB
音频解码	支持Dolby Digital Plus、DTS
视频解码	H.264、VC-1、WMV、MPEG1/2/4最大至 1080P@30帧/秒；real7/8/9最大至720P@30帧/秒
视频格式	支持RM、FLV、MOV、AVI、MKV、TS、MP4
无线传屏	Miracast、WiDi
智能分享	支持 AirPlay™、DLNA 协议的图像、音频和视频推送

 

1． 选择目标设备

您可以自行选择您的应用所面向发行的小米电视平台设备种类，当然面向的设备种类越多，就意味着更高的潜在下载量。当您面向多种设备发行时，一个应用要同时支持您选择的所有目标设备，一定要确保您的应用可以在目标设备上正常显示，且所有目标设备上的显示保持一致，关于如何开发适配多种显示尺寸的应用请参考Supporting Multiple Screens。发布多个相同内容的应用分别支持不同目标设备的行为是不允许的，将导致您的应用无法通过审核。

以下是小米电视设备的显示参数，小米在2013年12月已经推出符合谷歌显示标准的MiTV系统升级包（2014年3月末会推出盒子版本），已经售出的设备将逐步升级到谷歌标准（新发售的设备已经使用谷歌标准），但是系统升级是用户自愿行为，所以应用对于目标设备的新旧显示标准都需要支持。两种显示的不同之处已用红字标出。开发者可以根据以下参数来适配相应的目标设备。

小米电视设备旧规格	设备	MiBox1, MiBox1S	MiTV
	Screen size	xlarge(1280dpx720dp)	xlarge(1280dpx720dp)
		sw720dp	sw720dp
		Pix:1280×720	Pix:1920×1080
	Screen pixel density(dpi)	mdpi	hdpi
	Orientation	land	land
	Aspect ratio	long	long
谷歌对安卓电视设备的显示标准	设备	MiBox1, MiBox1S	MiTV
	Screen size	large(960dpx540dp)	large(960dpx540dp)
		sw540dp	sw540dp
		Pix:1280×720	Pix:1920×1080
	Screen pixel density(dpi)	tvdpi	xhdpi
	Orientation	land	land
	Aspect ratio	long	long

 

如果您的应用是从安卓手机应用移植而来，我们强烈建议您参照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	两个键值都要支持，以满足未来系统需求。

补充材料：
Android HOME键那些事：http://blog.csdn.net/imyfriend/article/details/8293399

 

3． 广告与支付

可以使用页内广告，广告内容必须与应用本身相关，禁止发布与应用无关的第三方广告。不要使用非页内广告。

由于小米支付系统尚未实施，请不要使用任何第三方支付平台以及虚拟货币，小米支付系统上线后，会统一开始应用接入工作。目前支付方式建议：1. 实体商品货到付款。2. 扫描二维码在移动设备端完成支付。3. 银行卡或信用卡直接支付。

 

4． 应用安装与调试

1. 通过外部存储设备安装：将存放有目标apk的U盘或移动硬盘与小米电视或小米盒子连接（小米盒子需要OTG线），使用最新系统自带的高清播放器即可访问存储设备，安装apk。
2. 通过adb命令安装调试（小米盒子以及电视默认支持通过USB连接进行adb调试，网络adb没有开启）：

小米电视（黑色U口为调试用）：

1. 主页->小米电视设置->账户与安全
2. 允许安装未知来源应用，允许ADB调试。
3. 主页->应用商店->应用管理->系统应用->设置->开发者选项
4. 打开开发者选项（右上角开关）。
5. 勾选“USB调试”
6. 将电脑与小米电视通过USB线连接，即可通过adb命令安装应用以及调试。

小米盒子：

1. 设置->系统设置->账户与安全
2. 允许安装未知来源应用。
3. 将电脑与小米盒子通过USB线连接，即可通过adb命令安装应用以及调试。

 

5． 版本号规范

小米电视应用商店对于在其中发布的应用的版本号有统一的规范，版本号应该为三位，每位只能有一个数字，且不能包含任何字母，例如：1.0.1或3.0.2。以下版本号都为错误示范：1.0.0.1，v2.0.2，1.0.12。除此之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的，例如应用说明，应用内相关信息以及androidmanifest.xml内。

 

6． 应用图标规范

• 如何设计符合小米视觉规范的应用图标：

小米盒子应用图标视觉规范请参考：小米盒子应用商店_icon visual guide_v1.1

小米电视应用图标视觉规范请参考：小米TV应用商店_icon visual guide_v1.1

• 如何保证应用图标在目标设备上正确显示：

在apk的res文件夹下应该有drawable-mdpi，drawable-tvdpi，drawable-hdpi，drawable-xhdpi文件夹，将符合小米盒子视觉规范的应用图标放入drawable-mdpi和drawable-tvdpi；将符合小米电视视觉规范的应用图标放入drawable-hdpi和drawable-xhdpi。当然您可以根据面向的目标设备进行取舍，例如只在小米盒子上发行的话可以没有hdpi和xhdpi文件夹。

注：对于应用图标的显示，小米盒子会先从应用商店下载对应应用的图标，如果商店没有对应图标则显示apk内封装的图标，所以在你的应用上线之前，你在小米盒子上看到的应用图标不会以全尺寸显示，即使它是符合规范的。这是正常的现象，只需要确保你的图标符合小米规范，那么上线后自然会在盒子上正常显示；对于小米电视来说，应用图标是直接从apk中读取的，上线前后不会有区别。

 

7． 应用说明及宣传材料

应用说明可以使用户在下载安装前了解您的应用，有助于您的应用获得更多的用户，但请如实描述您的应用，避免过分的夸大和过度宣传。请按照以下模板提供您的应用信息：

小米TV应用商店-应用信息规范

小米盒子应用商店-应用信息规范

注：针对小米TV发布的应用别忘记按照以上要求同时提供应用截图。

推荐位是小米电视应用商店特有的推广方式，可以使您的应用更直接的展现给用户以提高下载量，为了使您的应用可以被我们推荐，请您按照以下要求提供推荐位素材。

小米TV应用商店-推荐位图片素材规范

 

8． Recovery模式

双系统

有时出于开发原因可能需要手动升级一些小米盒子和小米电视的系统版本，这时需要用到Recovery模式http://bbs.xiaomi.cn/thread-8323439-1-1.html：

手动升级版本步骤：

1. 将版本放入U盘根目录下。
2. 将U盘与设备连接。
3. 进入recovery模式，升级自动开始。

除此以外recovery模式还提供恢复出厂设置的功能。

 

9． MiBox1S内存

MiBox1S上系统内存与显存是共享的，所以要注意显存的占用，过多的占用显存会导致系统内存不足，干扰系统正常工作。