文檔僅適用于大彩M型系列串口屏產品。

二、開發環境版本

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

2.串口屏固件版本：V6.3.325.0 及以上的版本。

三、使用說明

針對M型系列的視頻播放功能，利用視頻控件播放視頻時，視頻圖層會一直顯示在最上層，此時如果我們將文字等其他圖形疊加放在視頻控件上顯示時，視頻圖層會將其他圖形都覆蓋，導致只能顯示出視頻，而無法顯示視頻上疊放的其他文字和圖形。

為此，我司針對有此類需求的客戶開發了對應的M系列視頻底層播放API接口，來滿足此類客戶的需求。

• API函數接口：set_color_key(Min_Color,Max_Color,Match)
• u 函數說明：

a) Min_Color：24位RGB顏色范圍的最小值，例如0x00BFBFBF，R-BF/G-BF/B-BF；

b) Min_Color：24位RGB顏色范圍的最大值，例如0x00C8C8C8，R-C8/G-C8/B-C8；

c) Match：6位的比較規則101010(2A)；10-R/10-G/10-B，代表顏色范圍在0x00BFBFBF—0x00C8C8C8之間的顏色值經過比較后會被過濾。(0x00BFBFBF <= color <= 0x00C8C8C8之間的顏色會被過濾，其他顏色會顯示出來)

function on_init() set_color_key(0x00BFBFBF,0x00C8C8C8,0x0000002A) end

注：set_color_key(Min_Color,Max_Color,Match)，此API接口函數必須要放在on_init()系統初始化函數中使用，默認在初始時配置的屬性。

四、示例說明

4.1 AV輸入坐標顯示

4.1.1工程屬性配置介紹

• 視頻控件配置：拖動選擇視頻控件，用途選擇播放AV輸入。
• 按鈕配置：

◎上：控制十字光標顯示坐標y減。

◎下：控制十字光標顯示坐標y加。

◎左：控制十字光標顯示坐標x減。

◎右：控制十字光標顯示坐標x加。

4.1.2LUA腳本邏輯實現

溫馨提示：因平臺限制，UA腳本配置實現代碼：請移步 http://www.gz-dc.com/article/id/6645.html 下載。

4.2 視頻播放任意形狀

4.2.1 視頻空間屬性配置

• 視頻控件配置：拖動選擇視頻控件，用途選擇為播放視頻。
• 底色或UI配置：由于此處使用的和上節AV輸入為同一工程，此處也將視頻的底色或UI配置為和AV輸入一樣。

注：set_color_key(Min_color,Max_color,Match)API接口函數只能在on_onit()初始化中進行配置，且整個工程只能配置一次。

用戶可根據自己需求實現不同形狀的視頻播放窗口，利用上述API接口設置視頻控件的顏色比較過濾來達到不同形狀的視頻顯示窗口。例如Demo UI中利用灰色作為底色畫出的該形狀的圖形，通過set_color_key設置顏色過濾以達到的顯示該特定形狀的視頻窗口。

注：此處的視頻控件范圍應大于需要顯示的該特定形狀的范圍。