一、適用范圍

本文檔適合大彩M 系列（固件版本 >= V6.3.249.0）串口屏產(chǎn)品使用。

二、開發(fā)環(huán)境版本

1. VisualTFT 軟件版本：V3.0.1.1137 及以上的版本。

版本查看：

1) 打開 VisualTFT 軟件啟動(dòng)頁(yè)面如圖 2-1 軟件版本，右上角會(huì)顯示的軟件版本號(hào)；

圖2-1軟件版本

2)打開VisualTFT，在軟件右下角可以查看軟件版本圖2-2軟件版本，最新版本可登錄http://www.gz-dc.com/進(jìn)行下載。

圖2-2軟件版本

2. 串口屏硬件版本：

版本查看：

1)查看屏幕背面版本號(hào)貼紙；

2) VisualTFT與屏幕聯(lián)機(jī)成功后，右下角顯示的版本號(hào)。

三、概述

M系列的串口屏支持視頻，可應(yīng)用于個(gè)性化的開機(jī)視頻，產(chǎn)品上電時(shí)候，開機(jī)視頻更能體現(xiàn)產(chǎn)品的特色及應(yīng)用領(lǐng)域。

四、參考資料

1. 《LUA 腳本API V1.4》可通過以下鏈接下載物聯(lián)型開發(fā)包獲取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

2. 《LUA基礎(chǔ)學(xué)習(xí)》可通過以下鏈接下載物聯(lián)型開發(fā)包獲取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

3. LUA腳本初學(xué)者可以通過下面鏈接進(jìn)行學(xué)習(xí)。

http://www.runoob.com/lua/lua-arrays.html

五、教程實(shí)現(xiàn)

5.1準(zhǔn)備工具和軟件

基本思路：指定啟動(dòng)畫面為開機(jī)視頻畫面，當(dāng)屏幕上電的時(shí)候，自動(dòng)跳轉(zhuǎn)到啟動(dòng)畫面。視頻播放時(shí)會(huì)觸發(fā)LUA腳本里面的on_video_notify(msg,v1,v2)回調(diào)函數(shù)，視頻播放結(jié)束后（msg = 0），切換到主頁(yè)面，完成開機(jī)視頻播放。虛擬屏不支持視頻播放，請(qǐng)下載到實(shí)體屏體驗(yàn)。在實(shí)現(xiàn)例程前需要作以下3個(gè)準(zhǔn)備：

1. 硬件平臺(tái)；

2. 軟件平臺(tái)；

3. UI素材；

5.1.1硬件平臺(tái)

該例程使用大彩M系列7寸串口屏DC80480M070_1111_0C為驗(yàn)證開發(fā)平臺(tái)。如圖5-1所示；

圖5-1M系列7寸串口屏

其他M系列的串口屏均可借鑒此教程。

5.1.2軟件

1.VisualTFT 上位機(jī)

使用大彩自主研發(fā)的上位機(jī)軟件VisualTFT配置工程，登錄http://www.gz-dc.com/下載。如圖5-2所示；

圖5-2上位機(jī)軟件

2.視頻轉(zhuǎn)換軟件

使用第三方工具對(duì)視頻進(jìn)行編碼轉(zhuǎn)換，點(diǎn)擊鏈接下載【視頻格式轉(zhuǎn)換工具】：http://www.gz-dc.com/category/typeid/412#mainTop。

視頻支持MP4 h264編碼，音頻支持MP3編碼，且最大分辨率支持1280*720，最大幀速率30fps，最大比特率1400kbps。轉(zhuǎn)換操作說明可參考《【物聯(lián)型】串口屏_如何播放視頻_V1.0.pdf》 文檔中的‘4. 視頻格式轉(zhuǎn)換(.MP4)’小節(jié)。http://www.gz-dc.com/uploads/file/20200217/【物聯(lián)型】串口屏_如何播放視頻_V1.0.pdf

聲明：視頻轉(zhuǎn)換工具來自網(wǎng)絡(luò)，僅供學(xué)習(xí)，如有版權(quán)問題，請(qǐng)聯(lián)系刪除

5.2M系列配置

本文主要介紹以下2點(diǎn)：

(1)UI配置

(2)Lua編輯

5.2.1UI配置

1.工程屬性配置

雙擊工程名稱，顯示工程屬性窗口，將啟動(dòng)畫面選擇為開機(jī)視頻畫面、圖片格式默認(rèn)為BMP（壓縮），如圖5-3所示。

圖5-3工程屬性配置

2.畫面配置

建議視頻畫面的背景為黑或原視頻的第一幀，如圖5-4所示。

圖5-4畫面配置

3.控件配置

在畫面ID0中，添加一個(gè)視頻控件（控件ID1），視頻控件屬性如圖5-5所示：(1)位置：視頻控件的顯示起始坐標(biāo)、大小(2)用途：可用為播放AV輸入或播放視頻(3)視頻文件：加載的視頻文件的路徑(4)音頻流：?jiǎn)⒂没蚪谩Ｈ暨x擇禁用將不播放原視頻的音頻(5)自動(dòng)播放：選擇為是，切換到該視頻頁(yè)面就自動(dòng)播放(6)播放結(jié)束時(shí)：不通知、發(fā)送通知、自動(dòng)切換下一頁(yè)。選‘發(fā)送通知’，MCU或Lua可根據(jù)該通知做靈活的邏輯操作。(7)重復(fù)次數(shù)：0為無限次。

圖5-5控件配置

5.2.2LUA腳本編輯

本例程將視頻播放結(jié)束時(shí)發(fā)出通知，腳本根據(jù)該通知進(jìn)行切換頁(yè)面。代碼清單如程序清單 1所示：

程序清單 1lua腳本

-下面列出了常用的回調(diào)函數(shù) --更多功能請(qǐng)閱讀<<物聯(lián)型LUA腳本API.pdf>> local sc_PowerOn = 0 local sc_mian = 1 --視頻播放通知，僅M系列支持 function on_video_notify(msg,v1,v2) --獲取當(dāng)前頁(yè)面 local cur_screen = get_current_screen() --視播放頁(yè)面且視頻一播放完畢 if cur_screen == sc_PowerOn and msg == 0 then --執(zhí)行切換頁(yè)面操作 change_screen(sc_main) end end

核心API函數(shù)

1)on_video_notify(msg,v1,v2)

視頻播放通知，該API 物聯(lián)型不支持。

• msg：0-播放完畢，1-播放中
• v1：v1，已播放的進(jìn)度，單位秒
• v2：V2，總時(shí)長(zhǎng)，單位秒