电视/盒子应用开发指南

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

特别注意事项

您的应用必须在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增强版、MiBox mini版;MiTV1、MiTV2-49、MiTV2-55、MiTV2S上。设备的配置参数详见 http://www.mi.com/mitv40/

1. 选择目标设备

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

谷歌对安卓电视设备的显示标准 设备 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:359579789、Email:yangxun@xiaomi.com 。

实物支付方式建议:1. 实体商品货到付款。2. 通过扫描二维码在移动设备端完成支付。

4. 数据统计服务

第三方应用需要接入小米统计服务,用于小米TV应用商店内部相关推荐位优化和数据运营参考使用。

接入方法详见:小米TV应用商店–数据统计服务

注:已上线应用,接入数据统计服务后需递增版本号重新上传,谢谢。

5. 应用安装与调试

  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命令安装应用以及调试。

6. 版本号规范

版本号不能超过10位,建议版本号主要使用数字和“.”;除此之外您还要确保在所涉及的各方面应用所显示的版本号都是一致的,例如应用说明,应用内相关信息以及androidmanifest.xml内。

7.应用图标规范

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

小米盒子应用图标有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中读取的,上线前后不会有区别。

8. 小米TV商店水印规范

对于提交到小米电视应用商店的应用,需要在应用主页添加“小米电视应用商店”的水印。

  • 无合作应用,需要在应用主页显示”小米TV商店”的水印,水印的样式和文字不能修改,颜色和摆放的位置可以根据应用的具体情况调整。

9. 应用提交及宣传材料

开发者在http://dev.mi.com/注册,在”电视应用”页面按照提示填写各项信息后提交应用。 推荐位是小米电视应用商店特有的推广方式,可以使您的应用更直接的展现给用户以提高下载量,为了使您的应用可以被我们推荐,请您按照以下要求提供推荐位素材。 小米TV应用商店-推荐位图片素材规范

10. Recovery模式 双系统

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

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

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

11. 内存控制

部分型号小米盒子/小米电视产品中的系统内存与显存是共享的,所以要注意显存的占用,过多的显存占用会导致系统内存不足,干扰系统正常工作。