大彩串口屏M系列-开机视频的应用

卡米拉

http://video.gz-dc.com/%E3%80%90M%E7%B3%BB%E5%88%97%E3%80%91%20%E2%80%93%20%E5%BC%80%E6%9C%BA%E8%A7%86%E9%A2%91%E5%BA%94%E7%94%A8.mp4

演示视频

一、适用范围
本文档适合大彩M 系列（固件版本 >= V6.3.249.0）串口屏产品使用。

二、开发环境版本
1. VisualTFT 软件版本：V3.0.0.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-1  M系列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.2 M系列配置
本文主要介绍以下2点：
(1) UI配置
(2) Lua编辑

5.2.1 UI配置
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.2 LUA脚本编辑
本例程将视频播放结束时发出通知，脚本根据该通知进行切换页面。代码清单如程序清单 1所示：

程序清单 1 lua脚本

1. -下面列出了常用的回调函数
   
2. --更多功能请阅读<<物联型LUA脚本API.pdf>>
   
3. 
   
4. local sc_PowerOn = 0
   
5. local sc_mian    = 1
   
6. 
   
7. --视频播放通知，仅M系列支持
   
8. function on_video_notify(msg,v1,v2)
   
9.     --获取当前页面
   
10.     local cur_screen = get_current_screen()
    
11. 
    
12.     --视播放页面且视频一播放完毕
    
13.     if cur_screen == sc_PowerOn and msg == 0
    
14.     then
    
15.         --执行切换页面操作
    
16.         change_screen(sc_main)
    
17.     end
    
18. end

复制代码

核心API函数

1) on_video_notify(msg,v1,v2)

视频播放通知，该API 物联型不支持。

• msg：0-播放完毕，1-播放中
• v1：v1，已播放的进度，单位秒
• v2：V2，总时长，单位秒