一、適用范圍

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

二、開發環境版本

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

版本查看：

1) 打開 VisualTFT 軟件啟動頁面如圖 2-1 軟件版本，右上角會顯示的軟件版本號；

圖2-1軟件版本

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

圖2-2軟件版本

2. 串口屏硬件版本：

版本查看：

1)查看屏幕背面版本號貼紙；

2) VisualTFT與屏幕聯機成功后，右下角顯示的版本號。

三、概述

M系列的串口屏支持視頻，可應用于個性化的開機視頻，產品上電時候，開機視頻更能體現產品的特色及應用領域。

四、參考資料

1. 《LUA 腳本API V1.4》可通過以下鏈接下載物聯型開發包獲取:

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

2. 《LUA基礎學習》可通過以下鏈接下載物聯型開發包獲取:

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

3. LUA腳本初學者可以通過下面鏈接進行學習。

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

五、教程實現

5.1準備工具和軟件

基本思路：指定啟動畫面為開機視頻畫面，當屏幕上電的時候，自動跳轉到啟動畫面。視頻播放時會觸發LUA腳本里面的on_video_notify(msg,v1,v2)回調函數，視頻播放結束后（msg = 0），切換到主頁面，完成開機視頻播放。虛擬屏不支持視頻播放，請下載到實體屏體驗。在實現例程前需要作以下3個準備：

1. 硬件平臺；

2. 軟件平臺；

3. UI素材；

5.1.1硬件平臺

該例程使用大彩M系列7寸串口屏DC80480M070_1111_0C為驗證開發平臺。如圖5-1所示；

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

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

5.1.2軟件

1.VisualTFT 上位機

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

圖5-2上位機軟件

2.視頻轉換軟件

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

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

聲明：視頻轉換工具來自網絡，僅供學習，如有版權問題，請聯系刪除

5.2M系列配置

本文主要介紹以下2點：

(1)UI配置

(2)Lua編輯

5.2.1UI配置

1.工程屬性配置

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

圖5-3工程屬性配置

2.畫面配置

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

圖5-4畫面配置

3.控件配置

在畫面ID0中，添加一個視頻控件（控件ID1），視頻控件屬性如圖5-5所示：(1)位置：視頻控件的顯示起始坐標、大小(2)用途：可用為播放AV輸入或播放視頻(3)視頻文件：加載的視頻文件的路徑(4)音頻流：啟用或禁用。若選擇禁用將不播放原視頻的音頻(5)自動播放：選擇為是，切換到該視頻頁面就自動播放(6)播放結束時：不通知、發送通知、自動切換下一頁。選‘發送通知’，MCU或Lua可根據該通知做靈活的邏輯操作。(7)重復次數：0為無限次。

圖5-5控件配置

5.2.2LUA腳本編輯

本例程將視頻播放結束時發出通知，腳本根據該通知進行切換頁面。代碼清單如程序清單 1所示：

程序清單 1lua腳本

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

核心API函數

1)on_video_notify(msg,v1,v2)

視頻播放通知，該API 物聯型不支持。

• msg：0-播放完畢，1-播放中
• v1：v1，已播放的進度，單位秒
• v2：V2，總時長，單位秒