如何适配阿里YUNOSTV平台
YUNOS TV类型和配置
阿里YUNOS TV终端数众多,我们为开发者提供最具参考性的终端参数,帮助开发者适配。
目前YUNOS TV应用中心主要运行在MagicBox 1,MagicBox1S,MagicBox1S pro,MagicBox1S+(或2C),MagicBox2设备上,下面是这几款设备的具体配置参数:
注:YunOS联盟盒子和一体机机型众多,配置参数待分维度整理后补充。
YUNOS TV显示参数
对于不同类型的设备,其显示参数会有一定的不同,为保证开发者的应用能够在各个设备上正常显示,且在各个平台上的体验保持一致,开发者需要能够适配多种尺寸的应用,可参考《Optimize Layouts for Larger Screens》。
类型 参数 | |
Screen Size | sw720p |
Screen pixel density | mdpi |
Orientation | landscape |
Aspect ratio | long |
YUNOS TV应用UI规范
在YUN OS上开发的应用在字体、控件等UI方面有一定的标准规范,开发者可以按照这个规范来对自身应用进行适配或者开发。
遥控器、手柄等外设键值
TV应用或者游戏在适配的过程中需要适配遥控器的键值,可选择是否适配手柄等其他外设的键值,并确保使用遥控器可以完成应用的所有操作。Linux和Android键值是键值适配的两个标准,建议优先适配Linux键值,同时兼容Android。具体外设适配和接入可以下载外设SDK
Linux键值 | Android键值 | 备注 |
KEY_LEFT (105) | KEYCODE_DPAD_LEFT | 方向左键 |
KEY_UP (103) | KEYCODE_DPAD_UP | 方向上键 |
KEY_RIGHT (106) | KEYCODE_DPAD_RIGHT | 方向右键 |
KEY_DOWN (108) | KEYCODE_DPAD_DOWN | 方向下键 |
KEY_MENU (139) | KEYCODE_MENU | 菜单键 |
KEY_HOMEPAGE (172) | KEYCODE_HOME | 主页键 |
KEY_ESC (001) | KEYCODE_BACK | 返回键 |
KEY_ENTER (028) | KEYCODE_DPAD_CENTER | 确认键 |
KEY_VOLUMEUP(115) | KEYCODE_VOLUME_UP(24) | 音量键增 |
KEY_VOLUMEDOWN(114) | KEYCODE_VOLUME_DOWN(25) | 音量键减 |
BTN_A (0x130) | KEYCODE_BUTTON_A | 游戏A Button键 |
BTN_B (0x131) | KEYCODE_BUTTON_B | 游戏B Button键 |
BTN_X (0x133) | KEYCODE_BUTTON_X | 游戏X Button键 |
BTN_Y (0x134) | KEYCODE_BUTTON_Y | 游戏Y Button键 |
BTN_TL (0x136) | KEYCODE_BUTTON_L1 | 游戏L1 Button键 |
BTN_TL2 (0x138) | KEYCODE_BUTTON_L2 | 游戏L2 Button键 |
BTN_TR (0x137) | KEYCODE_BUTTON_R1 | 游戏R1 Button键 |
BTN_TR2 (0x139) | KEYCODE_BUTTON_R2 | 游戏R2 Button键 |
BTN_SELECT (0x13a) | KEYCODE_BUTTON_SELECT | 游戏Select Button键 |
BTN_START (0x13b) | KEYCODE_BUTTON_START | 游戏Start Button键 |
BTN_THUMBL (0x13d) | KEYCODE_BUTTON_THUMBL | Left Thumb Button |
BTN_THUMBR (0x13e) | KEYCODE_BUTTON_THUMBR | Right Thumb Button |
应用规范
应用规范:
应用的版本号Version Code格式:210AABBBCC,版本号不能超过10位。
前段210为前缀。 AABBB,5位,用于表明版本号,比如1.7可以表示为01007,2.0.0表示为02000。 CC每个版本的小版本号,预留100个,用于bug修改和小功能升级时使用。
图标规范:
TV应用中心目前采用了两种图片规范,分为2.5及以下版本和2.6及以上版本,在适配的时候需要制作两种不同规格的图表进行适配。
2.5及以下版本的应用中心图标采用340x460尺寸的图片,在制作图片的时候需要注意图片的视觉焦点在340x328(距起始50px)区域,底部的340x112区域为文字蒙版区域,在该区域不要出现复杂图形,或包含重要信息。
2.6及以上版本的应用中心图标采用340 x340尺寸的图片,制作图片的时候需要注意图片的视觉焦点在256 x256区域。
图标上勿加文字或角标。