阿里TV开放平台文档 / 如何适配阿里YUNOSTV平台

如何适配阿里YUNOSTV平台

YUNOS TV类型和配置


阿里YUNOS TV终端数众多,我们为开发者提供最具参考性的终端参数,帮助开发者适配。

目前YUNOS TV应用中心主要运行在MagicBox 1,MagicBox1S,MagicBox1S pro,MagicBox1S+(或2C),MagicBox2设备上,下面是这几款设备的具体配置参数:

1450334462663_6512bd43d9caa6e02c990b0a82652dca (1).png

1450334462663_6512bd43d9caa6e02c990b0a82652dca.png


注: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方面有一定的标准规范,开发者可以按照这个规范来对自身应用进行适配或者开发。

1450332794935_c4ca4238a0b923820dcc509a6f75849b.png




遥控器、手柄等外设键值

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区域。

图标上勿加文字或角标。


TB16WBQOVXXXXcsXFXXXXXXXXXX-1268-714.png


1450332962519_a87ff679a2f3e71d9181a67b7542122c.jpg