小米应用开发者文档
电视/盒子应用开发指南
欢迎加入小米电视应用开发，与我们一起创造客厅娱乐的未来，在着手开发或者适配前，请确保您已经认真阅读《小米应用商店应用审核指南》，因为触犯上述条款中的任何内容将会导致您的应用无法通过审核，或者被我们进行下线处理。
特别注意事项
您的应用必须在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、MiBox增强版、MiTV1和MiTV2上。下面是目前五款设备的配置参数：
项目 MiBox1 MiBox1S MiTV1 MiBox增强版 MiTV2
屏幕尺寸 / / 47英寸(LG)/48英寸(三星) / 49英寸（LG/华星光电）
分辨率 1280*720 1280*720 1920*1080 4K (3840*2160) 4K (3840*2160)
CPU Cortex-A9 Cortex-A9 高通骁龙 600 MPQ8064 Cortex-A9 Cortex-A9
800MHz 双核1.5GHz 四核1.7GHz 四核2.0GHz 四核1.45G
GPU Mali-400 Mali-400 双核 Adreno320 Mali-450MP6 Mali-450MP4
内存 1024MB 1024MB 2048MB 2048MB DDR3双通道 2048MB DDR3双通道
WiFi 2.4GHz 2.4GHz/5GHz 2.4GHz/5GHz 2.4GHz/5GHz 2.4GHz/5GHz
802.11a/b/g/n 802.11a/b/g/n 802.11a/b/g/n,2x2MIMO 802.11a/b/g/n/ac 802.11a/b/g/n/ac,2x2MIMO
蓝牙 / BT4.0 BT4.0 BT4.0 BLE BT4.0 BLE
系统版本 Android 4.1.2 Android 4.2.2 Android 4.1.2 Android 4.4 Android 4.3
系统存储 4GB 4GB 8GB 4GB 8GB
音频解码 支持Dolby Digital Plus、DTS
/ / / / Dolby Audio 虚拟环绕技术/自动音量平衡
视频解码 H.264、VC-1、WMV、MPEG1/2/4最大至 1080P@30帧/秒；real7/8/9最大至720P@30帧/秒 H.264支持到4K@30fps、MPEG1/2/4最大至 1080P@60帧/秒；VC-1、WMV、real7/8/9最大至1080@60帧/秒 支持H.265，H.264、H.265 支持到 4K@30fps、MPEG1/2/4、real7/8/9最大至 1080@30 帧/秒
视频格式 支持RM、FLV、MOV、AVI、MKV、TS、MP4
无线传屏 Miracast、WiDi
智能分享 支持 AirPlay™、DLNA 协议的图像、音频和视频推送
1． 选择目标设备
您可以自行选择您的应用所面向发行的小米电视平台设备种类，当然面向的设备种类越多，就意味着更高的潜在下载量。当您面向多种设备发行时，一个应用要同时支持您选择的所有目标设备，一定要确保您的应用可以在目标设备上正常显示，且所有目标设备上的显示保持一致，关于如何开发适配多种显示尺寸的应用请参考Supporting Multiple Screens。发布多个相同内容的应用分别支持不同目标设备的行为是不允许的。
2014年之前发布的小米电视设备存在新旧两种显示标准，应用对目标设备的两种标准都需要做适配支持。以下是小米电视设备的显示参数：
小米电视设备旧规格 设备 MiBox1, MiBox1S MiTV1
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 MiBox增强版, MiTV1, MiTV2
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键及Home键后，应用能够暂停运行。除了小米遥控器之外，有线或无线的游戏手柄，鼠标，键盘等其他外设也是支持的，在适配小米遥控器的基础上，开发者可以自愿添加对于其他附件的支持，在此不予详述。下面是小米遥控器的键值。
按键
键值
说明
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． 广告与支付
可以使用页内广告，广告内容必须与应用本身相关，禁止发布与应用无关的第三方广告，不要使用非页内广告。
由于TV应用商店已上线米币支付系统，请不要使用任何第三方支付平台以及虚拟货币，接入请联系相关商务，贺佳 QQ:1660169113、Mobile:18500789810；杨寻 QQ:359579789、Mobile:13581615751 。
实物支付方式建议：1. 实体商品货到付款。2. 扫描二维码在移动设备端完成支付。
4． 应用安装与调试
通过外部存储设备安装：将存放有目标apk的U盘或移动硬盘与小米电视或小米盒子连接（小米盒子需要OTG线），使用最新系统自带的高清播放器即可访问存储设备，安装apk。
通过adb命令安装调试（小米盒子以及电视默认支持通过USB连接进行adb调试，网络adb没有开启）：
小米电视（黑色U口为调试用）：
主页->小米电视设置->账户与安全
允许安装未知来源应用，允许ADB调试。
主页->应用商店->应用管理->系统应用->设置->开发者选项
打开开发者选项（右上角开关）。
勾选“USB调试”
将电脑与小米电视通过USB线连接，即可通过adb命令安装应用以及调试。
小米盒子：
设置->系统设置->账户与安全
允许安装未知来源应用。
将电脑与小米盒子通过USB线连接，即可通过adb命令安装应用以及调试。
5． 版本号规范
版本号不能超过10位，建议版本号主要使用数字和“.”；除此之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的，例如应用说明，应用内相关信息以及androidmanifest.xml内。
6．应用图标规范
如何设计符合小米视觉规范的应用图标：
小米盒子应用图标有2个，分别是200*200px和300*300px，均为直角，包含标题文字；
标视觉规范请参考：小米盒子应用商店_icon visual guide_v2.0
小米盒子图标的图层结构/图层样式详参源文件：
guide_source_720p
guide_source_1080p
小米电视应用图标应为284*160px，圆角，不包含标题文字；
视觉规范请参考：小米TV应用商店_icon visual guide_v1.1
小米TV图标的图层结构/图层样式详参源文件：
guide_source_a
guide_source_b
图标标题字体“方正兰亭粗黑”字体文件请下载方正兰亭粗黑参考。
小米电视应用4K图标应为512*512px，直角，不包含标题文字；
视觉规范请参考：小米TV应用商店_icon 4K visual guide_v1.0
如何保证应用图标在目标设备上正确显示：
在apk的res文件夹下应该有drawable-mdpi和 drawable-xhdpi文件夹，
drawable-mdpi: 放入符合小米盒子视觉规范的应用图标（200*200px）；
drawable-xhdpi: 放入符合小米电视视觉规范的应用图标（284*160px）。
注：对于应用图标的显示，小米盒子会先从应用商店下载对应应用的图标，如果商店没有对应图标则显示apk内封装的图标，所以在你的应用上线之前，你在小米盒子上看到的应用图标不会以全尺寸显示，即使它是符合规范的。这是正常的现象，只需要确保你的图标符合小米规范，那么上线后自然会在盒子上正常显示；对于小米电视来说，应用图标是直接从apk中读取的，上线前后不会有区别。
7． 小米TV商店水印规范
对于提交到小米TV商店的应用，需要在应用主页添加“小米首发/独家”或“小米TV商店”的水印。
首发/独家合作的应用，需要在应用主页显示”小米tv商店首发&独家水印“水印，水印的样式和文字不能修改，颜色和摆放的位置可以根据应用的具体情况调整。
无合作应用，需要在应用主页显示”小米TV商店”的水印，水印的样式和文字不能修改，颜色和摆放的位置可以根据应用的具体情况调整。
8． 应用提交及宣传材料
开发者在http://dev.mi.com/注册，在”电视应用”页面按照提示填写各项信息后提交应用。
推荐位是小米电视应用商店特有的推广方式，可以使您的应用更直接的展现给用户以提高下载量，为了使您的应用可以被我们推荐，请您按照以下要求提供推荐位素材。
小米TV应用商店-推荐位图片素材规范
9． Recovery模式
双系统 有时出于开发原因可能需要手动升级一些小米盒子和小米电视的系统版本，这时需要用到Recovery模式http://bbs.xiaomi.cn/thread-8323439-1-1.html： 手动升级版本步骤：
将版本放入U盘根目录下。
将U盘与设备连接。
进入recovery模式，升级自动开始。
除此以外recovery模式还提供恢复出厂设置的功能。
10． 内存控制
欢迎加入小米电视应用开发，与我们一起创造客厅娱乐的未来，在着手开发或者适配前，请确保您已经认真阅读《小米应用商店应用审核指南》，因为触犯上述条款中的任何内容将会导致您的应用无法通过审核，或者被我们进行下线处理。
特别注意事项
您的应用必须在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、MiBox增强版、MiTV1和MiTV2上。下面是目前五款设备的配置参数：
项目 MiBox1 MiBox1S MiTV1 MiBox增强版 MiTV2
屏幕尺寸 / / 47英寸(LG)/48英寸(三星) / 49英寸（LG/华星光电）
分辨率 1280*720 1280*720 1920*1080 4K (3840*2160) 4K (3840*2160)
CPU Cortex-A9 Cortex-A9 高通骁龙 600 MPQ8064 Cortex-A9 Cortex-A9
800MHz 双核1.5GHz 四核1.7GHz 四核2.0GHz 四核1.45G
GPU Mali-400 Mali-400 双核 Adreno320 Mali-450MP6 Mali-450MP4
内存 1024MB 1024MB 2048MB 2048MB DDR3双通道 2048MB DDR3双通道
WiFi 2.4GHz 2.4GHz/5GHz 2.4GHz/5GHz 2.4GHz/5GHz 2.4GHz/5GHz
802.11a/b/g/n 802.11a/b/g/n 802.11a/b/g/n,2x2MIMO 802.11a/b/g/n/ac 802.11a/b/g/n/ac,2x2MIMO
蓝牙 / BT4.0 BT4.0 BT4.0 BLE BT4.0 BLE
系统版本 Android 4.1.2 Android 4.2.2 Android 4.1.2 Android 4.4 Android 4.3
系统存储 4GB 4GB 8GB 4GB 8GB
音频解码 支持Dolby Digital Plus、DTS
/ / / / Dolby Audio 虚拟环绕技术/自动音量平衡
视频解码 H.264、VC-1、WMV、MPEG1/2/4最大至 1080P@30帧/秒；real7/8/9最大至720P@30帧/秒 H.264支持到4K@30fps、MPEG1/2/4最大至 1080P@60帧/秒；VC-1、WMV、real7/8/9最大至1080@60帧/秒 支持H.265，H.264、H.265 支持到 4K@30fps、MPEG1/2/4、real7/8/9最大至 1080@30 帧/秒
视频格式 支持RM、FLV、MOV、AVI、MKV、TS、MP4
无线传屏 Miracast、WiDi
智能分享 支持 AirPlay™、DLNA 协议的图像、音频和视频推送
1． 选择目标设备
您可以自行选择您的应用所面向发行的小米电视平台设备种类，当然面向的设备种类越多，就意味着更高的潜在下载量。当您面向多种设备发行时，一个应用要同时支持您选择的所有目标设备，一定要确保您的应用可以在目标设备上正常显示，且所有目标设备上的显示保持一致，关于如何开发适配多种显示尺寸的应用请参考Supporting Multiple Screens。发布多个相同内容的应用分别支持不同目标设备的行为是不允许的。
2014年之前发布的小米电视设备存在新旧两种显示标准，应用对目标设备的两种标准都需要做适配支持。以下是小米电视设备的显示参数：
小米电视设备旧规格 设备 MiBox1, MiBox1S MiTV1
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 MiBox增强版, MiTV1, MiTV2
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键及Home键后，应用能够暂停运行。除了小米遥控器之外，有线或无线的游戏手柄，鼠标，键盘等其他外设也是支持的，在适配小米遥控器的基础上，开发者可以自愿添加对于其他附件的支持，在此不予详述。下面是小米遥控器的键值。
按键
键值
说明
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． 广告与支付
可以使用页内广告，广告内容必须与应用本身相关，禁止发布与应用无关的第三方广告，不要使用非页内广告。
由于TV应用商店已上线米币支付系统，请不要使用任何第三方支付平台以及虚拟货币，接入请联系相关商务，贺佳 QQ:1660169113、Mobile:18500789810；杨寻 QQ:359579789、Mobile:13581615751 。
实物支付方式建议：1. 实体商品货到付款。2. 扫描二维码在移动设备端完成支付。
4． 应用安装与调试
通过外部存储设备安装：将存放有目标apk的U盘或移动硬盘与小米电视或小米盒子连接（小米盒子需要OTG线），使用最新系统自带的高清播放器即可访问存储设备，安装apk。
通过adb命令安装调试（小米盒子以及电视默认支持通过USB连接进行adb调试，网络adb没有开启）：
小米电视（黑色U口为调试用）：
主页->小米电视设置->账户与安全
允许安装未知来源应用，允许ADB调试。
主页->应用商店->应用管理->系统应用->设置->开发者选项
打开开发者选项（右上角开关）。
勾选“USB调试”
将电脑与小米电视通过USB线连接，即可通过adb命令安装应用以及调试。
小米盒子：
设置->系统设置->账户与安全
允许安装未知来源应用。
将电脑与小米盒子通过USB线连接，即可通过adb命令安装应用以及调试。
5． 版本号规范
版本号不能超过10位，建议版本号主要使用数字和“.”；除此之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的，例如应用说明，应用内相关信息以及androidmanifest.xml内。
6．应用图标规范
如何设计符合小米视觉规范的应用图标：
小米盒子应用图标有2个，分别是200*200px和300*300px，均为直角，包含标题文字；
标视觉规范请参考：小米盒子应用商店_icon visual guide_v2.0
小米盒子图标的图层结构/图层样式详参源文件：
guide_source_720p
guide_source_1080p
小米电视应用图标应为284*160px，圆角，不包含标题文字；
视觉规范请参考：小米TV应用商店_icon visual guide_v1.1
小米TV图标的图层结构/图层样式详参源文件：
guide_source_a
guide_source_b
图标标题字体“方正兰亭粗黑”字体文件请下载方正兰亭粗黑参考。
小米电视应用4K图标应为512*512px，直角，不包含标题文字；
视觉规范请参考：小米TV应用商店_icon 4K visual guide_v1.0
如何保证应用图标在目标设备上正确显示：
在apk的res文件夹下应该有drawable-mdpi和 drawable-xhdpi文件夹，
drawable-mdpi: 放入符合小米盒子视觉规范的应用图标（200*200px）；
drawable-xhdpi: 放入符合小米电视视觉规范的应用图标（284*160px）。
注：对于应用图标的显示，小米盒子会先从应用商店下载对应应用的图标，如果商店没有对应图标则显示apk内封装的图标，所以在你的应用上线之前，你在小米盒子上看到的应用图标不会以全尺寸显示，即使它是符合规范的。这是正常的现象，只需要确保你的图标符合小米规范，那么上线后自然会在盒子上正常显示；对于小米电视来说，应用图标是直接从apk中读取的，上线前后不会有区别。
7． 小米TV商店水印规范
对于提交到小米TV商店的应用，需要在应用主页添加“小米首发/独家”或“小米TV商店”的水印。
首发/独家合作的应用，需要在应用主页显示”小米tv商店首发&独家水印“水印，水印的样式和文字不能修改，颜色和摆放的位置可以根据应用的具体情况调整。
无合作应用，需要在应用主页显示”小米TV商店”的水印，水印的样式和文字不能修改，颜色和摆放的位置可以根据应用的具体情况调整。
8． 应用提交及宣传材料
开发者在http://dev.mi.com/注册，在”电视应用”页面按照提示填写各项信息后提交应用。
推荐位是小米电视应用商店特有的推广方式，可以使您的应用更直接的展现给用户以提高下载量，为了使您的应用可以被我们推荐，请您按照以下要求提供推荐位素材。
小米TV应用商店-推荐位图片素材规范
9． Recovery模式
双系统 有时出于开发原因可能需要手动升级一些小米盒子和小米电视的系统版本，这时需要用到Recovery模式http://bbs.xiaomi.cn/thread-8323439-1-1.html： 手动升级版本步骤：
将版本放入U盘根目录下。
将U盘与设备连接。
进入recovery模式，升级自动开始。
除此以外recovery模式还提供恢复出厂设置的功能。
10． 内存控制
部分型号小米盒子/小米电视产品中的系统内存与显存是共享的，所以要注意显存的占用，过多的显存占用会导致系统内存不足，干扰系统正常工作。
转载自：http://dev.xiaomi.com/doc/?p=2212