《小米电视、盒子应用开发指南》由会员分享，可在线阅读，更多相关《小米电视、盒子应用开发指南（6页珍藏版）》请在金锄头文库上搜索。
1、电视/盒子应用开发指南欢迎加入小米电视应用开发，与我们一起创造客厅娱乐的未来，在着手开发或者适配前，请确保您已经认真阅读小米应用商店应用审核指南 ，因为触犯上述条款中的任何内容将会导致您的应用无法通过审核，或者被我们进行下线处理。特别注意事项您的应用必须在 manifest 中使用将其定义为电视应用，这样才能在应用上传时被系统分类为电视应用，从而进入正确的审核流程，定义方法如下：参考： http:/ MiBox1，MiBox1S 和 MiTV 上，也就是说小米电视应用商店上的应用程序是暂时面向以上三款设备发行的，当然随着小米电视平台新产品的推出，应用商店的应用将会面向更多的设备。下面是目前三款
2、设备的配置参数：项目 MiBox1 MiBox1S MiTV屏幕尺寸 / / 47 英寸(LG)/48 英寸(三星)分辨率 1280*720 1280*720 1920*1080Cortex-A9 Cortex-A9 高通骁龙 600 MPQ8064CPU800MHz 双核 1.5GHz 四核 1.7GHzGPU Mali-400 Mali-400 双核 Adreno320内存 1024MB 1024MB 2048MB2.4GHz 2.4GHz/5GHz 2.4GHz/5GHzWiFi802.11a/b/g/n 802.11a/b/g/n 802.11a/b/g/n 2x2MIMO蓝牙 / B
3、T4.0 BT4.03D 成像 偏振式(需外接设备支持) 偏振式(需外接设备支持) 偏振式系统版本 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 最大至 1080P30 帧/秒； real7/8/9 最大至 720P30帧/秒视频格式 支持 RM、FLV、MOV、AVI、MKV、TS 、MP4无线传屏 Miracast、WiDi智能分享 支持 AirPlay、DLNA 协议的图像、音频和视频推送1 选择目标设
4、备您可以自行选择您的应用所面向发行的小米电视平台设备种类，当然面向的设备种类越多，就意味着更高的潜在下载量。当您面向多种设备发行时，一个应用要同时支持您选择的所有目标设备，一定要确保您的应用可以在目标设备上正常显示，且所有目标设备上的显示保持一致，关于如何开发适配多种显示尺寸的应用请参考 Supporting Multiple Screens。发布多个相同内容的应用分别支持不同目标设备的行为是不允许的，将导致您的应用无法通过审核。以下是小米电视设备的显示参数，小米在 2013 年 12 月已经推出符合谷歌显示标准的 MiTV系统升级包（2014 年 3 月末会推出盒子版本） ，已经售出的设备将
5、逐步升级到谷歌标准（新发售的设备已经使用谷歌标准） ，但是系统升级是用户自愿行为，所以应用对于目标设备的新旧显示标准都需要支持。两种显示的不同之处已用红字标出。开发者可以根据以下参数来适配相应的目标设备。设备 MiBox1, MiBox1S MiTVxlarge(1280dpx720dp) xlarge(1280dpx720dp)sw720dp sw720dpScreen size Pix:1280720 Pix:19201080Screen pixel density(dpi) mdpi hdpiOrientation land land小米电视设备旧规格Aspect ratio long
6、long设备 MiBox1, MiBox1S MiTV谷歌对安卓电视设备的显示标准 Screen size large(960dpx540dp) large(960dpx540dp)sw540dp sw540dpPix:1280720 Pix:19201080Screen pixel density(dpi) tvdpi xhdpiOrientation land landAspect ratio long long如果您的应用是从安卓手机应用移植而来，我们强烈建议您参照 Optimize your layouts for larger screens 重新优化应用的 UI 已使其充分利用大尺
7、寸显示的空间，给用户带来适合大屏设备的观看体验。如果您的应用已经适配了安卓平板电脑且符合谷歌的设计指导，它将更容易适配到小米电视平台。2 适配小米遥控器小米电视平台标配的人机交互方式为小米遥控器，所有应用必须适配小米遥控器，也就是说使用小米遥控器可以浏览应用的所有内容，实现应用的所有功能。小米遥控器为小米电视平台设备通用，也就是说一个遥控器可以支持所有小米电视平台设备。除了小米遥控器之外，有线或无线的游戏手柄，鼠标，键盘等其他外设也是支持的，在适配小米遥控器的基础上，开发者可以自愿添加对于其他附件的支持，在此不予详述。下面是小米遥控器的键值。按键 键值 说明Power KeyEvent.KEY
8、CODE_POWER在任意画面按下后设备休眠，当前应用在前台暂停运行；设备唤醒后（依然通过power 键） ，应用恢复运行，或者保持暂停状态由用户选择是否恢复（对于视频播放也可以退出播放回到播放前画面） 。Home KeyEvent.KEYCODE_HOMEMiTV：功能与安卓标准 Home 键一致。在任意画面按下后切换到系统主页，当前应用切换到后台暂停运行，再次点击应用图标恢复运行。MiBox1 和 MiBox1S：在任意画面按下后切换到系统主页，同时系统将当前应用自动关闭。Back KeyEvent.KEYCODE_BACK功能与安卓标准 Back 键一致。在应用主页按下后不得直接退出应用
9、，应该给用户适当提示，由用户确认是否退出。Menu KeyEvent.KEYCODE_MENU 功能与安卓标准 Menu 键一致。Volume Down KeyEvent.KEYCODE_VOLUME_DOWNMiBox1 的标配遥控器无此按键，在 MiBox1上有声应用需要自行实现应用音量调节，无法实现的有声应用不能在 MiBox1 上发行。Volume Up KeyEvent.KEYCODE_VOLUME_UPMiBox1 的标配遥控器无此按键，在 MiBox1上有声应用需要自行实现应用音量调节，无法实现的有声应用不能在 MiBox1 上发行。Left KeyEvent.KEYCODE_D
10、PAD_LEFTRight KeyEvent.KEYCODE_DPAD_RIGHTUp KeyEvent.KEYCODE_DPAD_UPDown KeyEvent.KEYCODE_DPAD_DOWNOK/Center KeyEvent.KEYCODE_DPAD_CENTER/KeyEvent.KEYCODE_ENTER 两个键值都要支持，以满足未来系统需求。补充材料：Android HOME 键那些事：http:/ 广告与支付可以使用页内广告，广告内容必须与应用本身相关，禁止发布与应用无关的第三方广告。不要使用非页内广告。由于小米支付系统尚未实施，请不要使用任何第三方支付平台以及虚拟货币，小米
11、支付系统上线后，会统一开始应用接入工作。目前支付方式建议：1. 实体商品货到付款。2. 扫描二维码在移动设备端完成支付。3. 银行卡或信用卡直接支付。4 应用安装与调试通过外部存储设备安装：将存放有目标 apk 的 U 盘或移动硬盘与小米电视或小米盒子连接（小米盒子需要 OTG 线） ，使用最新系统自带的高清播放器即可访问存储设备，安装apk。通过 adb 命令安装调试（小米盒子以及电视默认支持通过 USB 连接进行 adb 调试，网络 adb 没有开启）：小米电视（黑色 U 口为调试用）：主页-小米电视设置-账户与安全允许安装未知来源应用，允许 ADB 调试。主页-应用商店-应用管理-系统应
12、用-设置-开发者选项打开开发者选项（右上角开关） 。勾选“USB 调试”将电脑与小米电视通过 USB 线连接，即可通过 adb 命令安装应用以及调试。小米盒子：设置-系统设置-账户与安全允许安装未知来源应用。将电脑与小米盒子通过 USB 线连接，即可通过 adb 命令安装应用以及调试。5 版本号规范小米电视应用商店对于在其中发布的应用的版本号有统一的规范，版本号应该为三位，每位只能有一个数字，且不能包含任何字母，例如：1.0.1 或 3.0.2。以下版本号都为错误示范：1.0.0.1 ，v2.0.2，1.0.12。除此之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的，例如应用说明，应
13、用内相关信息以及 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-t
14、vdpi；将符合小米电视视觉规范的应用图标放入 drawable-hdpi 和 drawable-xhdpi。当然您可以根据面向的目标设备进行取舍，例如只在小米盒子上发行的话可以没有hdpi 和 xhdpi 文件夹。注：对于应用图标的显示，小米盒子会先从应用商店下载对应应用的图标，如果商店没有对应图标则显示 apk 内封装的图标，所以在你的应用上线之前，你在小米盒子上看到的应用图标不会以全尺寸显示，即使它是符合规范的。这是正常的现象，只需要确保你的图标符合小米规范，那么上线后自然会在盒子上正常显示；对于小米电视来说，应用图标是直接从 apk 中读取的，上线前后不会有区别。7 应用说明及宣传材料
15、应用说明可以使用户在下载安装前了解您的应用，有助于您的应用获得更多的用户，但请如实描述您的应用，避免过分的夸大和过度宣传。请按照以下模板提供您的应用信息：小米 TV 应用商店-应用信息规范小米盒子应用商店-应用信息规范注：针对小米 TV 发布的应用别忘记按照以上要求同时提供应用截图。推荐位是小米电视应用商店特有的推广方式，可以使您的应用更直接的展现给用户以提高下载量，为了使您的应用可以被我们推荐，请您按照以下要求提供推荐位素材。小米 TV 应用商店-推荐位图片素材规范8 Recovery 模式双系统有时出于开发原因可能需要手动升级一些小米盒子和小米电视的系统版本，这时需要用到 Recovery 模式 http:/ U 盘根目录下。将 U 盘与设备连接。进入 recovery 模式，升级自动开始。除此以外 recovery 模式还提供恢复出厂设置的功能。9 MiBox1S 内存MiBox1S 上系统内存与显存是共享的，所以要注意显存的占用，过多的占用显存会导致系统内存不足，干扰系统正常工作。This entry was posted in 技术文档 on 2014 年 2 月 19 日 by 宗, 博洋.
