更新選取的選項播放器
顯示播放器參數
顯示播放器控制項
內嵌頁框程式碼
注意:
上述的嵌入程式碼會反映您在播放器參數表單中針對
list
或
playlist
參數輸入的內容設定。如果您希望嵌入程式碼使用「播放器控制項」
表單中指定的內容,就必須移除這些值。
內容
您可以選擇在播放器中載入或提示內容。 如果您選取 [載入] 內容並更新播放器,播放器將會播放指定內容,而不會播放已播放的影片 (如果有的話)。
如果您選取了「提示」內容並更新播放器的選項,播放器會載入影片,但不會播放。
如要播放影片,您必須按一下播放器控制項部分中的 [播放]
連結,或是在影片播放器中進行設定。
本頁將依您的選擇,呼叫下列其中一個 API 函式:
loadVideoById
loadVideoByUrl
loadPlaylist
cueVideoById
cueVideoByUrl
CuPlayPlay 清單
載入含有影片 ID 的影片:
載入含有影片 ID 的影片清單:
載入播放清單 ID 的播放清單:
載入頻道上傳的影片:
影片 ID 提示影片:
含有影片 ID 的影片提示清單:
提示播放清單,播放清單 ID:
提示頻道上傳的影片:
選取選項
載入含有影片 ID 的影片:
載入含有影片 ID 的影片:
載入含有影片 ID 的影片清單:
載入播放清單 ID 的播放清單:
載入頻道上傳的影片:
影片 ID 提示影片:
含有影片 ID 的影片提示清單:
提示播放清單,播放清單 ID:
提示頻道上傳的影片:
開始時間 (以影片開頭算起的秒數):
控制項
本節中的控制項可讓您播放、暫停或停止影片。
如要尋找影片的特定時間點,請在 [跳轉到]
欄位中輸入一個數字,用來指定影片開始播放後的時間點偏移 (以秒為單位)。
播放
|
暫停
|
停止
跳轉到:
前往
返回
|
繼續
前往 (播放清單索引號碼):
前往
循環播放影片:
關閉
|
開啟
隨機播放影片:
隨機播放
|
返回原始順序
音量
靜音和取消靜音控制項可開啟或關閉音量。「統計資料」
部分中的 [開啟/關閉音量]
欄位會顯示播放器是否為靜音狀態。
在 [設定音量]
欄位中輸入 0 到 100 的數字,即可調整玩家的音量。按 Tab 鍵或點選輸入框外,即可調整音量。
靜音
|
取消靜音
|
設定:
(0-100)
[目前等級:
100
]
播放速率
播放速率可識別影片播放的速度。
getAvailableplayRates()
函式會傳回目前影片可用的播放速率組合。在本示範中,可用播放速率會顯示在「統計資料」
部分中。
值為
1
表示影片以正常速度播放。
更新播放速率
大小
本節可讓您使用
setSize(width, height)
函式修改播放器的大小。這個函式通常只適合在 ActionScript 應用程式中使用。在 JavaScript 應用程式中,調整大小後的播放器仍會插入包含影片播放器的物件中,即使該物件小於或大於調整大小的播放器也一樣。
長寬比:
16x9
四輪驅動
選取選項
16x9
16x9
四輪驅動
尺寸:
x
405
更新播放器大小
記錄
當播放器準備好播放影片時,本頁面會呼叫
getVideoUrl()
和
getEmbedCode()
函式。如果您載入影片或將影片顯示為預備畫面,就會再次呼叫這些函式。
如果您在影片播放至少 10 秒後呼叫
getVideoUrl()
,網址就會包含參數,指定播放器開始播放影片的時間偏移。
(清除)
錯誤
目前沒有任何地址。
事件和函式呼叫
目前沒有任何地址。
播放器參數
• 核取方塊框 = 參數值為
1
• 未勾選方塊 = 參數值為
0
• 使用
Iframe 嵌入程式碼
嵌入播放器,以使用選定的選項。
參數
值
自動播放
1
– 在播放器載入時自動開始播放影片。
0
(預設) – 不會在播放器載入時自動播放影片。
cc_load_policy
1
– 即使使用者關閉字幕,系統仍會顯示隱藏式輔助字幕。預設行為是根據使用者的喜好而定。
顏色
這個參數可指定播放器的影片進度列,用來顯示觀眾已看過的影片數量。預設值為
red
(紅色)。
紅色
白色
選取選項
紅色
紅色
白色
控制項
1
– (預設) 影片播放器中的播放器控制項。
0
– 不要在影片播放器中顯示播放器控制項。
disablekb
1
– 停用播放器鍵盤控制項。
0
(預設):啟用播放器鍵盤控制項。鍵盤控制項包括:
空格鍵:播放/暫停
向左鍵:在目前播放的影片中往回跳過幾秒。
向右鍵:在目前播放的影片中往前跳過幾秒。
向上鍵:調高音量
向下鍵:調低音量
enablejsapi
1
– 啟用 IFrame Player API 來控製播放器。
0
(預設) – 不啟用 API。
結束
影片應停止播放的時間偏移。這個值為正整數,用於指定播放器停止播放的影片秒數。
fs
1
(預設):播放器會顯示一個可檢視全螢幕播放器的按鈕。
0
– 播放器不會顯示按鈕。
hl
設定播放器的介面語言。參數值為 ISO 639-1 雙字母語言代碼或完整指定的語言代碼,例如
fr
或
fr-ca
。系統也可以正確處理其他的語言輸入代碼,例如 IETF 語言代碼 (BCP 47)。
播放器的工具提示語言也會影響預設字幕軌。
iv_load_policy
1
(預設) – 顯示影片註解。
3
:不顯示影片註解。
1
3
選取選項
1
1
3
list
這個參數搭配
list
參數使用,可識別在播放器中載入的內容。
playlist
:
list
參數會指定 YouTube 播放清單 ID。請確定參數值的開頭為
PL
。
user_uploads
:
list
參數可指定要載入哪一個 YouTube 頻道所上傳的影片。
listType
這個參數搭配
list
參數使用,可以識別在播放器中載入的內容。
user_uploads
:
list
參數可指定要載入哪一個 YouTube 頻道所上傳的影片。
playlist
:
list
參數會指定 YouTube 播放清單 ID。請確定參數值的開頭為
PL
。
user_uploads
播放清單
選取選項
user_uploads
user_uploads
播放清單
迴圈
1
– 如果播放器正在載入單一影片,請再次播放影片。如果播放器正在載入播放清單,請播放整個播放清單,再於第一部影片開始播放。
0
(預設) – 請不要連續播放影片或整個播放清單。
適度品牌
1
– 禁止 YouTube 標誌顯示在控制列中。當使用者的滑鼠游標移到播放器上時,仍會顯示 YouTube 文字標籤或浮水印。
0
– 在播放器控制列中顯示 YouTube 標誌。
播放清單
影片清單 (以逗號分隔),可連續播放。
playinline
1
– 為
UIWebViews
建立內嵌播放,並將
allowsInlineMediaplay
屬性設為
TRUE
。
0
(預設) – 讓全螢幕播放。請注意,預設值可能會隨時變動。
開始
影片開始播放的時間偏移。這個值必須為正整數,表示播放器開始播放時的影片秒數。播放器會在您指定的時間或前後尋找最近的主要畫面格。
統計資料
本節中的資訊描述影片播放器和播放的影片 (或最後播放的影片)。下列清單列出與本節中每個欄位相關聯的 API 函式:
持續時間:getDuration()
目前時間:getCurrentTime()
播放器狀態:getPlayerState()
已載入的影片百分比:getVideoLoadedFraction()
開始位元組:getVideoStartBytes()
音量 (開啟/關閉):isMuted()
播放清單的影片數:count(getPlaylist())
目前影片的位置:getPlaylistIndex()
播放清單中的影片:getPlaylist()
已載入的位元組:getVideoBytesLoaded() (已淘汰)
位元組總數:getVideoBytesTotal() (已淘汰)
請寫出
播放清單中的影片數量:
undefined
目前影片的位置:
-1
播放清單中的影片: