主題鎖屏與插件修改之MAML教程[特選參考]

1、 MAML教程MORE & MAML 概述-MAML在百變鎖屏中的應(yīng)用-MAML在百變壁紙及動(dòng)態(tài)圖標(biāo)中的應(yīng)用壁紙?jiān)?變量-變量數(shù)組-全局變量-表達(dá)式-文本-時(shí)間-日期-圖片-數(shù)字圖片-圖片遮罩-元素動(dòng)畫-Slider-按鈕-音樂播放器-音量調(diào)節(jié)-Content Provider-Trigger & Command-動(dòng)態(tài)幀率-傳感器調(diào)用- -1-2-2-3-3-4-6-7-8-9-9-10-10-11-11-13-15-17-19-19-23-28-28二類嚴(yán)選#MORE & MAML 概述 MAML引擎腳本語言MIUI Application Markup Language for MORE

2、 （MIUI MORE引擎應(yīng)用標(biāo)記語言） MORE渲染引擎Markup Oriented Rendering Engine （基于標(biāo)記語言的渲染引擎） 概述最初用于百變鎖屏，使用xml用特定的語法描述鎖屏界面。后來不斷增強(qiáng)功能，逐步演化成一套接近通用的界面描述語言和圖形渲染引擎，在一定需求下可用于開發(fā)風(fēng)格多變的用戶界面?？煞奖愕赝ㄟ^更換皮膚改變界面風(fēng)格、動(dòng)畫甚至交互方式。MAML語言和Android的界面描述xml 類似. 所不同的是Android描述的是靜態(tài)界面，對(duì)界面元素的更改依賴java代碼。MAML描述的是靜態(tài)界面+動(dòng)態(tài)屬性，UI在時(shí)間線上按一定的幀率不斷刷新，UI顯示根據(jù)元素屬性的變

3、量表達(dá)式的計(jì)算結(jié)果實(shí)時(shí)更新。MAML語言和運(yùn)行時(shí)引擎已經(jīng)從鎖屏中獨(dú)立出來作為MIUI內(nèi)置的通用框架，除了顯示時(shí)間日期等，還支持查詢標(biāo)準(zhǔn)Content Provider來獲取各種信息如天氣。顯示圖片文本等各種元素，各種動(dòng)畫，滑動(dòng)點(diǎn)擊等界面交互控件，適于實(shí)現(xiàn)展示信息或有簡單交互操作的界面。比如時(shí)鐘、天氣小部件、鬧鐘響鈴界面?？蚣苤С謩?dòng)態(tài)幀率，不必按照固定幀率不停渲染，在沒有動(dòng)畫和更新的時(shí)侯停止渲染，此時(shí)僅占用極少資源，對(duì)于緩慢變化的動(dòng)畫使用低幀率渲染，高動(dòng)態(tài)的動(dòng)畫開始后立即調(diào)整到高幀率全速渲染。全速渲染時(shí)全屏幀率基本可以達(dá)到60幀。合理使用可以既炫酷又不費(fèi)電。 MORE引擎適用哪些類型的界面開發(fā)

4、1. 展示性的信息，如圖片，文字 （不適合列表信息和大段文本，不適合用戶輸入） 2. 需要有豐富的界面動(dòng)畫及交互動(dòng)畫。 3. 較簡單的交互，拖拽、點(diǎn)擊 （但不限于拖拽點(diǎn)擊，通過xml代碼可以實(shí)現(xiàn)部分類似java編程中onTouchEvent所能做到的交互） 4. 使用標(biāo)準(zhǔn)控件無法實(shí)現(xiàn)的信息展示方式，或者無法實(shí)現(xiàn)的交互方式，需要自制控件的，大部分可以通過xml代碼方便地描述實(shí)現(xiàn)。 5. 需要靈活更換皮膚風(fēng)格，并且界面動(dòng)畫和交互動(dòng)畫甚至部分交互方式都可以通過皮膚更換。無需更改應(yīng)用程序。比如一些簡單的工具類應(yīng)用程序、無輸入的操作界面希望能更換操作模式（例如來電接聽界面）和桌面小工具可以考慮使用，也可

5、以作為一個(gè)動(dòng)畫框架實(shí)現(xiàn)類似電子賀卡的界面，可支持交互，做為應(yīng)用程序中的彩蛋（比如短信中的生日彩蛋） MIUI主題使用MORE的模塊百變鎖屏 ernal.policy.impl.AwesomeLockScreen桌面時(shí)鐘 com.miui.home.launcher.gadget.AwesomeClock相框小工具 com.miui.home.launcher.gadget.PhotoFrame 鬧鐘響鈴界面 com.android.deskclock.AlarmAlertFullScreen自由桌面動(dòng)態(tài)小部件 com.miui.home.launcher.gadg

6、et.AwesomeGadget百變壁紙 com.miui.home.launcher.MiWallpaper （基于SurfaceView）動(dòng)態(tài)圖標(biāo)天氣小工具 com.miui.home.launcher.gadget.Weather_2x4_custom (v4)MAML在百變鎖屏中的應(yīng)用百變鎖屏在主題包里的lockscreen/advance目錄下，manifest.xml文件是描述腳本 frameRate： 指定幀率，如果動(dòng)畫緩慢，可以指定小一點(diǎn)的值，省電。默認(rèn)為30。displayDesktop: 默認(rèn)為false，透視到桌面功能，如果沒有鎖屏壁紙或者鎖屏壁紙可以被移開或透明時(shí)可以看

7、到桌面launcher或者是鎖屏前的應(yīng)用程序?？梢酝昝缹?shí)現(xiàn)WP7，Meego，阿里云等的解鎖界面。showSysWallpaper: 默認(rèn)為false,是否在鎖屏界面顯示桌面壁紙。開啟后如果沒有指定鎖屏壁紙,會(huì)將桌面壁紙作為鎖屏的壁紙。screenWidth： 設(shè)定屏幕寬度標(biāo)準(zhǔn)。如果指定為720,鎖屏中所有元素的位置都按720p的布局編寫，480p的手機(jī)會(huì)自動(dòng)進(jìn)行縮放。MAML在百變壁紙及動(dòng)態(tài)圖標(biāo)中的應(yīng)用 百變壁紙百變壁紙?jiān)谥黝}包的miwallpaper目錄下，描述文件也是manifest.xml。根節(jié)點(diǎn)表示與百變鎖屏基本一致： width:表示百變壁紙的寬度。 height:表示高度另外，如

8、果要實(shí)現(xiàn)元素跟隨手指滑動(dòng)的效果，需要借助#wallpaper_offset_pixel_x，#wallpaper_offset_xwallpaper_offset_pixel_x：偏移的像素?cái)?shù) （0 -1*屏寬）wallpaper_offset_x：偏移百分比 （0 1.0）二者關(guān)系：#wallpaper_offset_x * 屏寬 = -1*#wallpaper_offset_pixel_x滑動(dòng)時(shí)： 在第一屏，wallpaper_offset_pixel_x = 0, wallpaper_offset_x = 0; 滑到最后一屏，wallpaper_offset_pixel_x = -1*屏

9、寬，wallpaper_offset_x = 1.0為了適配不同分辨率機(jī)型，建議使用#wallpaper_offset_x。建議的設(shè)計(jì)方式：壁紙切成雙屏寬 （屏寬指的是screenWidth）壁紙定位：x=-#wallpaper_offset_x * 屏寬需要跟隨滑動(dòng)的元素定位：x=-#wallpaper_offset_x * 屏寬 + 相對(duì)壁紙的位置 動(dòng)態(tài)圖標(biāo)動(dòng)態(tài)圖標(biāo)在主題包iconsfancy_icons目錄下，每個(gè)動(dòng)態(tài)圖標(biāo)是一個(gè)文件夾，文件夾的名字是對(duì)應(yīng)的app包名。例如日歷的動(dòng)態(tài)圖標(biāo)是一個(gè)叫com.android.calendar的文件夾，里面包含manifest.xml描述文件 hi

10、deApplicationMessage: 默認(rèn)false,屏蔽右上角的通知標(biāo)志。useVariableUpdater： 指定需要哪些系統(tǒng)變量，目前包括電量和時(shí)間，而且可以指定時(shí)間的更新周期，如果時(shí)間小工具每秒更新一次，需要指定更新周期為1秒，否則默認(rèn)會(huì)每分鐘更新一次。如果小工具或動(dòng)態(tài)圖標(biāo)只顯示日期，則每天更新一次，可以指定更新周期為1天。盡量選擇較長的更新周期，以節(jié)約系統(tǒng)資源。目前支持的tag： Battery, DateTime.Day, DateTime.Hour,DateTime.Minute,DateTime.Second如果某個(gè)小工具不需要電量或時(shí)間變量，則需要使用useVaria

11、bleUpdater=none，指定不做時(shí)間變量等更新。如果某個(gè)小工具顯示系統(tǒng)電量并且顯示根據(jù)時(shí)間每小時(shí)更換背景圖片: useVariableUpdater=Battery,DateTime.Hour如果需要每秒進(jìn)行多次刷新，可以直接使用frameRate壁紙?jiān)豔allpaper元素引用系統(tǒng)設(shè)置的壁紙，除了不能指定圖片源外其他和Image元素相同，可以有動(dòng)畫和其他屬性控制。如果沒有此元素則不顯示壁紙?？梢杂卸鄠€(gè)。 例子： 變量變量 name 變量名 expression 變量對(duì)應(yīng)的表達(dá)式或常量 注意：如果定義字符串常量需要多一套單引號(hào): expression=my string type=

12、number/string 定義數(shù)值變量或字符串變量 默認(rèn)：number const =true 變量只會(huì)在初始化時(shí)計(jì)算一次，以后不會(huì)重新計(jì)算，可以提高效率。如果變量值會(huì)在鎖屏運(yùn)行期間改變，const設(shè)為false 默認(rèn)：false threshold 閾值觸發(fā)，當(dāng)變量值的變化超過設(shè)定的閾值時(shí)，可以觸發(fā)一些命令。例如： 上述代碼表示#time3的值每變化1，就會(huì)執(zhí)行里面的所有命令 persist 默認(rèn)false，變量持久化。指定為ture后，如果沒有重新給定該變量其他的值，那么這個(gè)值會(huì)一直保存，無論解鎖后重新鎖定或者重新應(yīng)用主題都不會(huì)還原變量數(shù)組 變量數(shù)組 . . Item 數(shù)組元素定義 ex

13、pression 元素對(duì)應(yīng)的表達(dá)式 value 如果元素是常量，則用value指定常量值/ 定義了一個(gè)每隔兩秒輪換一次日期顯示格式的DateTime元素./ 數(shù)組元素可以用來根據(jù)數(shù)字變量值顯示不同的字符串 / 顯示英文月份 . 全局變量unlocker: unlocker.move_x 解鎖部件在x方向的偏移 unlocker.move_y 解鎖部件在y方向的偏移 unlocker.move_dist 解鎖部件移動(dòng)的距離 unlocker.state 解鎖部件的狀態(tài)： 0 normal, 1 pressed, 2 reachedtouch： touch_x 當(dāng)前觸摸點(diǎn)的x坐標(biāo) touch_y

14、touch_begin_x 按下屏幕時(shí)的初始x坐標(biāo) touch_begin_y touch_begin_time 按下屏幕時(shí)的時(shí)間time: time 當(dāng)前時(shí)間，long time_sys 系統(tǒng)時(shí)間毫秒數(shù) year 年份 month 月份（取值范圍是011，0表示一月，1表示二月，以此類推） date 日期 day_of_week 星期（1表示星期日，2表示星期一，等等） hour12 當(dāng)前小時(shí)（12小時(shí)制） hour24 24小時(shí)制 minute 分鐘 second 秒 ampm 上下午 0:am 1:pm time_format 0:12h 1:24h農(nóng)歷 year_lunar 農(nóng)歷年份

15、year_lunar1864 用來計(jì)算天干地支 month_lunar 農(nóng)歷月份 從1開始計(jì) month_lunar_leap 0/1 是否潤月 date_lunar 農(nóng)歷日期 從1開始計(jì)battery: battery_level 當(dāng)前電量，1100 battery_state 0正常 1充電 2電量低 3已充滿screen: screen_width 屏幕寬度 screen_height 屏幕高度 raw_screen_width 物理寬度（這個(gè)表示當(dāng)前設(shè)備的屏幕分辨率，不受根節(jié)點(diǎn)screenWidth的影響） raw_screen_height 物理高度image: image.actu

16、al_x 圖片實(shí)際x坐標(biāo) image.actual_y image.actual_w 圖片實(shí)際寬度 image.actual_h image.bmp_width 圖片文件的寬度（不受裁切、縮放的影響，只根據(jù)src找到指定的圖片，并檢測(cè)該文件的寬度）image.bmp_heightmusic: music_control.music_state 0暫停 1播放others: sms_unread_count 未讀短信數(shù) call_missed_count 未接電話數(shù) next_alarm_time 下一個(gè)鬧鐘時(shí)間 intercept_sys_touch 是否截獲以后的觸摸事件，避免被其他View

17、捕獲，例如在自由桌面widget中可以防止在widget上進(jìn)行觸摸操作時(shí)桌面滾動(dòng)和進(jìn)入編輯模式 frame_rate 當(dāng)前屏幕幀率 volume_type 0 通話音量 1 系統(tǒng)音量 2 電話鈴聲，短信鈴聲 3 音樂播放器音量 4 鬧鐘音量 5 通知音量 6 連接藍(lán)牙時(shí)的通話音量 7 在某些國家強(qiáng)制的系統(tǒng)音量 8 DTMF音量 9 TTS音量 10 FM音量 ring_mode 0 silent, 1 vibrate, 2 normal wifi_state 0 disabled, 1 enabled, 2 problem, 3 half(intermediate) bluetooth_sta

18、te 0 off, 1 on, 2 half data_state 0 off, 1 on usb_mode 0 disconnected, 1 charge only, 2 storage, 3 intermediate表達(dá)式支持加減乘除取模括號(hào)和函數(shù)加減乘除取模: + - * /%支持函數(shù):sin, cos, tan, asin, acos, atan, sinh, cosh, sqrt, abs, min, max 不解釋 len(數(shù)字) 給定數(shù)字位數(shù) len(1234)=4 digit(數(shù)字, 第幾位) 取給定數(shù)字的第幾位 digit(1234, 2) = 3 substr(原字符串，

19、字串開始位置，字串長度) substr(今天真熱,1,2) = 天真 round() 四舍五入取整 int()向下取整 eq(x, y) / x=y? 1: 0 ne(x, y) / x!=y? 1: 0 ge(x, y) / x=y? 1: 0 gt(x, y) / xy? 1: 0 le(x, y) / x0? 0: 1 ifelse(x, y, z) / x0? y: z ifelse(x1, y1, x2, y2, . , z) if x10 return y1; else if x20 return y2; .; else return z +可以拼接字符串 ， 一些函數(shù)也可以支持字

20、符串，isnull可以判斷字符串變量是否為空，ifelse可以選擇字符串，字符串比較函數(shù)eqs(string1, string2)元素可見性支持表達(dá)式 visibility=“表達(dá)式” 0可見Image, Text, Time的屬性align= left, center, right 坐標(biāo)點(diǎn)水平對(duì)齊方式alignV= top, center, bottom 坐標(biāo)點(diǎn)垂直對(duì)齊方式文本顯示指定格式的文字，坐標(biāo)屬性支持變量 color： 文字顏色，#FFFFFF size: 文字大小 format： 如果需要在文字中顯示變量數(shù)字，需要指定格式, 用%d 指定數(shù)字位置 paras: 如果指定了forma

21、t, 需要在paras里指定%d對(duì)應(yīng)的變量表達(dá)式, 可以有多個(gè)變量表達(dá)式用, 隔開 align： left, center, right，文字坐標(biāo)的對(duì)齊方式 textExp: 文字表達(dá)式，可以直接調(diào)用變量等如想要輸出“現(xiàn)在時(shí)間是9點(diǎn)”，可以寫成textExp=現(xiàn)在時(shí)間是+#hour12+點(diǎn) width 文字寬度,當(dāng)文字超過指定寬度時(shí)會(huì)被切掉。如果指定了多行顯示，則會(huì)折行顯示。如果指定了文字滾動(dòng)，則會(huì)在指定的位置滾動(dòng)顯示文字 marqueeSpeed 文字滾動(dòng)速度，配合上面的寬度使用 marqueeGap 滾動(dòng)間隔。當(dāng)文字顯示完后再次出現(xiàn)的間隔，默認(rèn)為四個(gè)漢字的寬度 rotation（X,Y,Z

22、） 旋轉(zhuǎn)角度，舊的angle也可以使用，不過建議用rotation，因?yàn)楸容^高端大氣國際化 multiLine ture/false 是否支持多行顯示，默認(rèn)false spacingMult 行距倍數(shù) 默認(rèn)1 spacingAdd 行距增加量 默認(rèn)0 text.text_width 某行文本的寬度，可以用來排版#tt.text_width實(shí)例用法：顯示下一個(gè)鬧鐘時(shí)間 textExp屬性支持字符串表達(dá)式： *天氣信息，如果溫度為空顯示- 非空顯示數(shù)值時(shí)間src表示時(shí)間圖片的前綴，如下表示使用time_0.png, time_1.png, . time_9.png, time_dot.png. 坐

23、標(biāo)屬性支持變量表達(dá)式space表示時(shí)間圖片的間隙，我們可以使用這個(gè)功能來對(duì)時(shí)間圖片進(jìn)行排版，使用正值時(shí)圖片間距變大，這時(shí)可以將圖片切小，節(jié)省內(nèi)存。對(duì)于有投影的圖片，將space寫成負(fù)值，可以使投影重疊以節(jié)省空間日期顯示指定格式的日期format: 支持標(biāo)準(zhǔn)日期格式, 另外增加農(nóng)歷: NNNN 九月： M - 9MM - 097分鐘: m - 7mm - 07mmm - 007mmmm - 00071970年4月6日 3:23am yyyy/MM/dd h:mmaa - 1970/04/06 3:23amM月d日 h:mmaa - 4月6日 3:23am星期 E - 周三EEEE - 星期三紀(jì)念

24、日: M/d - 紀(jì)念日: 4/624小時(shí): kk:mm - 13:34圖片圖片部件用來在鎖屏界面上顯示一個(gè)圖片，可以指定各種屬性 x,y 相對(duì)于屏幕左上角的坐標(biāo) w,h 寬和高 pivotX, pivotY 旋轉(zhuǎn)中心 rotation 旋轉(zhuǎn)角度，一周360度 src 圖片名稱 srcid 圖片序列后綴數(shù)字，一般用變量表示，可以根據(jù)變量顯示不同的圖片，如果src=pic.png srcid=1 則最后會(huì)顯示圖片 pic_1.png alpha 透明度 0-255, 小于等于0不顯示 antiAlias true/false 抗鋸齒，如果為true圖片在變形旋轉(zhuǎn)時(shí)不會(huì)有鋸齒，但是速度會(huì)慢 src

25、Exp 圖片源表達(dá)式 srcFormat 圖片源格式 srcForamtExp 圖片源格式表達(dá)式 srcParas 圖片源參數(shù) actual_x actual_y 元素實(shí)際位置變量，可以獲得元素在動(dòng)畫時(shí)的實(shí)際位置 align/alignV 對(duì)齊方式，上文已經(jīng)介紹。category 屬性 界面上除解鎖部件外所有元素可以指定 category屬性，Charging BatteryLow BatteryFull Normal， 指定了category屬性的元素僅會(huì)在該狀態(tài)下顯示，可以用來做充電文字，動(dòng)畫等的顯示。 如 例子: . /srcExp:圖片源表達(dá)式數(shù)字圖片 number是要顯示的數(shù)字表達(dá)式

26、 src是圖片源的文件名，支持SourceAnimation 如果src=number.png 則會(huì)使用 number_0.png number_1.png . 圖片文件來繪制數(shù)字。類似Time部件圖片遮罩 x,y 坐標(biāo) src 遮罩圖片，不透明黑色部分表示不透明，其他部分為透明。 align 坐標(biāo)是相對(duì)于所屬圖片還是絕對(duì)位置，如果是相對(duì)，圖片移動(dòng)是遮罩會(huì)相應(yīng)跟隨移動(dòng)。否則遮罩保持不動(dòng)。 遮罩同樣可以有源動(dòng)畫，旋轉(zhuǎn)動(dòng)畫，和位置動(dòng)畫，屬性支持變量表達(dá)式 元素動(dòng)畫所有元素都支持動(dòng)畫動(dòng)畫分為：圖片源，位置，大小，旋轉(zhuǎn)，透明度每種動(dòng)畫相互獨(dú)立，各自循環(huán)播放，動(dòng)畫由若干關(guān)鍵幀組成，關(guān)鍵幀包括幀屬性和時(shí)間

27、，除圖片源動(dòng)畫外，其它動(dòng)畫會(huì)根據(jù)當(dāng)前時(shí)間找到相鄰的兩個(gè)關(guān)鍵幀，然后線性插值計(jì)算當(dāng)前的屬性。 如果第一幀時(shí)間不從0開始，則默認(rèn)時(shí)間為0的第一幀為圖片原始屬性,時(shí)間單位為毫秒。 位置動(dòng)畫中的位置是相對(duì)于圖片自身的坐標(biāo)。 例子：位置動(dòng)畫表示1秒從屏幕最左端到最右端，停留1秒，透明度動(dòng)畫表示開始透明度為175，在從最左端到最右端過程中透明度不變，到達(dá)最右端后0.5秒漸變?yōu)椴煌该?，然?.5秒變?yōu)橥该飨А?然后循環(huán)播放。 注意：只有圖片支持圖片源動(dòng)畫圖片源動(dòng)畫稍有不同，沒有插值，x, y 可選，表示相對(duì)圖片的位置， 當(dāng)前的圖片是在列表里的找到第一個(gè)大于當(dāng)前時(shí)間的那個(gè)點(diǎn)指定的 Slider name: 名字，用來做變量名 bounceInitSpeed, bounceAccelation 回彈動(dòng)畫初始速度和加速度(距離單位為像素，時(shí)間單位為秒)，都支持表達(dá)式 alwaysShow=true/false 默認(rèn)是false，當(dāng)一個(gè)Slider可見時(shí)，其他Slider消失。 可以有任意個(gè)Slider部件。 Trigger Slider的狀態(tài)切換時(shí)，支持Trigger觸發(fā) Slider起始點(diǎn)：起始點(diǎn)中包含的元素都會(huì)跟隨當(dāng)前操作的拖動(dòng)移動(dòng)位置。 /從其他狀態(tài)切換到NormalState時(shí)，觸發(fā)該Trigger /從其他狀態(tài)切換到Pressed