如何适配阿里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区域。
图标上勿加文字或角标。