如何適配阿里YUNOSTV平臺
YUNOS TV類型和配置
阿里YUNOS TV終端數(shù)眾多，我們?yōu)殚_發(fā)者提供最具參考性的終端參數(shù)，幫助開發(fā)者適配。
目前YUNOS TV應(yīng)用中心主要運行在MagicBox 1，MagicBox1S，MagicBox1S pro，MagicBox1S+（或2C），MagicBox2設(shè)備上，下面是這幾款設(shè)備的具體配置參數(shù)：
注：YunOS聯(lián)盟盒子和一體機(jī)機(jī)型眾多，配置參數(shù)待分維度整理后補充。
YUNOS TV顯示參數(shù)
對于不同類型的設(shè)備，其顯示參數(shù)會有一定的不同，為保證開發(fā)者的應(yīng)用能夠在各個設(shè)備上正常顯示，且在各個平臺上的體驗保持一致，開發(fā)者需要能夠適配多種尺寸的應(yīng)用，可參考《Optimize Layouts for Larger Screens》。
類型 參數(shù) | |
Screen Size | sw720p |
Screen pixel density | mdpi |
Orientation | landscape |
Aspect ratio | long |
YUNOS TV應(yīng)用UI規(guī)范
在YUN OS上開發(fā)的應(yīng)用在字體、控件等UI方面有一定的標(biāo)準(zhǔn)規(guī)范，開發(fā)者可以按照這個規(guī)范來對自身應(yīng)用進(jìn)行適配或者開發(fā)。
遙控器、手柄等外設(shè)鍵值
TV應(yīng)用或者游戲在適配的過程中需要適配遙控器的鍵值，可選擇是否適配手柄等其他外設(shè)的鍵值，并確保使用遙控器可以完成應(yīng)用的所有操作。Linux和Android鍵值是鍵值適配的兩個標(biāo)準(zhǔn)，建議優(yōu)先適配Linux鍵值，同時兼容Android。具體外設(shè)適配和接入可以下載外設(shè)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 | 確認(rèn)鍵 |
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 |
應(yīng)用規(guī)范
應(yīng)用規(guī)范：
應(yīng)用的版本號Version Code格式：210AABBBCC，版本號不能超過10位。
前段210為前綴。 AABBB，5位，用于表明版本號，比如1.7可以表示為01007，2.0.0表示為02000。 CC每個版本的小版本號，預(yù)留100個，用于bug修改和小功能升級時使用。
圖標(biāo)規(guī)范：
TV應(yīng)用中心目前采用了兩種圖片規(guī)范，分為2.5及以下版本和2.6及以上版本，在適配的時候需要制作兩種不同規(guī)格的圖表進(jìn)行適配。
2.5及以下版本的應(yīng)用中心圖標(biāo)采用340x460尺寸的圖片，在制作圖片的時候需要注意圖片的視覺焦點在340x328（距起始50px）區(qū)域，底部的340x112區(qū)域為文字蒙版區(qū)域，在該區(qū)域不要出現(xiàn)復(fù)雜圖形，或包含重要信息。
2.6及以上版本的應(yīng)用中心圖標(biāo)采用340 x340尺寸的圖片，制作圖片的時候需要注意圖片的視覺焦點在256 x256區(qū)域。
圖標(biāo)上勿加文字或角標(biāo)。
