多媒體控制元件

# FastWeb媒體控制元件

適用平臺： APP(移動端)

此組中的控制元件為視訊播放、影音串流、製作條形碼等相關的元件。

# 1. TUgAppVideo

該元件為視訊播放的元件。可用該元件進行網路視訊的播放以及非RTMP直播視訊流的播放。

# 1.1. 屬性

屬性	功能說明
Controls	是否開啟視訊播放的滑鼠點選控制
Loop	是否開啟視訊的循環播放
Mute	設定是否開啟靜音
PosterUrl	設定視訊封面的地址
Urls	設定視訊播放的地址

# 1.1.1. Controls

property Controls: Boolean;

是否顯示視訊播放的控制按鈕，當設定為False時，視訊控制元件頁面將不顯示播放、暫停按鈕以及進度條等視訊控制組件。

# 1.1.2. Loop

property Loop: Boolean;

是否開啟視訊的循環播放。

# 1.1.3. PosterUrl

property Poster: string;

設定視訊控制元件未開始播放時的封面，可以使用網路地址來指定需要顯示的圖片資訊。

# 1.1.4. Urls

property PosterUrl: TStrings;

設定視訊地址的播放列表。

# 1.2. 事件

事件	何時觸發
OnMuteChange	當視訊靜音狀態發生變化時觸發該事件
OnPause	當視訊暫停時觸發該事件
OnPlay	當視訊開始播放時觸發該事件
OnStop	當視訊停止播放時觸發該事件
OnVolumeChange	當音量發生變化時觸發該事件

# 1.3. 方法

# 1.3.1. play

procedure play;

播放視訊。

# 1.3.2. Stop

procedure Stop;

停止播放視訊。

# 2. TUgBarCodeScanner

該元件用於掃瞄條形碼或者二維碼並解析。該控制元件須在https下才可使用。

# 2.1. 屬性

屬性	功能說明
ScanType	設定掃瞄的型別，可以設定識別二維碼或者條碼
CameraList	設定相機的列表

# 2.2. 事件

事件	何時觸發
OnError	當識別出錯時觸發該事件
OnResult	當識別到結果時觸發該事件

# 2.2.1. OnError

procedure UgBarcodeScannerOnError(sender: tobject;const error: string);

當識別出錯時觸發該事件。

//JScript
function UgBarcodeScanner01OnError(sender,error)
{
  ShowMessage(Error);
}

1
2
3
4
5

//PasScript
procedure UgBarcodeScanner01OnError(sender: tobject;const error: string);
begin
  ShowMessage(Error);
end;

1
2
3
4
5

// Make sure to add code blocks to your code group

# 2.2.2. OnResult

procedure UgBarcodeScannerOnResult(sender: tobject;const result: string);

當識別到結果時觸發該事件。

//JScript
function UgBarcodeScanner01OnResult(sender,result)
{
 UgAppMemo01.Lines.Add(Result);
}

1
2
3
4
5

//PasScript
procedure UgBarcodeScanner01OnResult(sender: tobject;const result: string);
begin
 UgAppMemo01.Lines.Add(Result);
end;

1
2
3
4
5

// Make sure to add code blocks to your code group

# 2.3. 方法

# 2.3.1. Decode

procedure Decode(DeviceID: string);

對選擇的相機進行解碼操作以顯示實時界面。設備ID來源於CameraList。

//JScript
function UgAppButton01OnClick(sender)
{
  if (UgAppSelect01.Items.Count>0)
  {
    UgBarcodeScanner01.Decode(UgAppSelect01.Items.ValueFromIndex[UgAppSelect01.ItemIndex]);
  }
}

1
2
3
4
5
6
7
8

//PasScript
procedure UgAppButton01OnClick(sender: tobject);
begin
  if UgAppSelect01.Items.Count>0 then
  begin
    UgBarcodeScanner01.Decode(UgAppSelect01.Items.ValueFromIndex[UgAppSelect01.ItemIndex]);
  end;
end;

1
2
3
4
5
6
7
8

// Make sure to add code blocks to your code group

# 2.3.2. Stop

procedure stop;

停止相機解碼。

# 3. TUgAppFlvPlayer

該元件用於在網頁端播放flv視訊檔案，播放不需要呼叫Flash外掛。可將其使用於低延遲的直播視訊播放。

提示

iOS系統的瀏覽器暫不支援此控制元件播放視訊，如有iOS系統播放視訊的需求請使用 TUgAppVideo。

# 3.1. 屬性

屬性	功能說明
AutoPlay	是否開啟自動播放
isLive	設定直播模式

# 3.2. 方法

# 3.2.1. Play

procedure Play;

開啟視訊播放。

# 3.2.2. Pause

procedure Pause;

暫停視訊播放

# 3.2.3. SetSource

procedure SetSource(Source: string; SourceType: string);

設定視訊源資訊。地址可以是視訊檔案（flv格式），也可以是直播視訊流的地址(http-flv)。如果使用https型別的地址則載入速度可能會變慢。

//JScript
UgAppFlvPlayer01.SetSource("http://www.example.com/live/sample.flv", "flv");

1
2

//PasScript
UgAppFlvPlayer01.SetSource('http://www.example.com/live/sample.flv', 'flv');

1
2

// Make sure to add code blocks to your code group

# 4. TUgSTT

此控制元件用於與語音識別服務對接，實現語音識別轉換為文字的功能。請注意，由於語音功能的要求，FastWeb需使用https 訪問才能正常使用。與這個控制元件對接的語音識別模型為 Paraformer (opens new window)，請參考模型部署的說明搭建語音識別服務進行對接，併爲語音識別的API服務部署證書。

# 4.1. 屬性

# 4.1.1. API

語音識別服務的API服務地址，這個地址需要使用https，且與Paraformer (opens new window)相容的響應格式。

# 4.1.2. Language

設定返回的語音識別結果的語言型別，目前支援zh-cn(簡體中文)、zh-tw(繁體中文)兩種語言型別。

# 4.2. 事件

# 4.2.1. OnAjaxEvent

語音識別的結果通過 OnAjaxEvent 返回。返回的事件名稱為 audiotext，返回的事件的參數名稱為 data，獲取語音識別的示例如下：

//JScript
function UgSTT01OnAjaxEvent(sender,eventname,params)
{
  if (SameText(eventname,"audiotext"))
  {
		UgEdit01.Text = params.Values["data"];
  }
}

1
2
3
4
5
6
7
8

//PasScript
procedure UgSTT01OnAjaxEvent(sender: TObject;eventname:string;params:string);
begin
  if SameText(eventname,'audiotext')
  begin
		UgEdit01.Text := params.Values['data'];
  end;
end;

1
2
3
4
5
6
7
8

// Make sure to add code blocks to your code group

# 4.3. 方法

# 4.3.1. Init

初始化控制元件功能，通常在程式啟動時來執行。

# 4.3.2. StartRecording

開始執行音訊錄製。

# 4.3.3. StopRecording

停止音訊錄製，將錄製的音訊發送至API服務。

← 伺服器控制元件 3D-AI控制元件→