自訂視訊檢視器

所有視覺化自訂和大部分行為自訂都是透過建立自訂CSS來完成。

建議的工作流程是為適當的檢視器取用預設的CSS檔案，將它複製到不同的位置，加以自訂，然後在style=命令中指定自訂檔案的位置。

您可在下列位置找到預設的CSS檔案：

<s7_viewers_root>/html5/VideoViewer.css

自訂CSS檔案必須包含與預設的類別宣告相同。 如果省略類別宣告，檢視器將無法正常運作，因為它不提供使用者介面元素的內建預設樣式。

提供自訂CSS規則的另一種方式，是直接在網頁或連結的外部CSS規則中使用內嵌樣式。

當您建立自訂CSS時，請記住檢視器會指派.s7videoviewer類別給其容器DOM元素。 如果您使用與style=命令一起傳遞的外部CSS檔案，請在CSS規則的子體選擇器中使用.s7videoviewer類作為父類。 如果您在網頁上內嵌樣式，請另外以容器DOM元素的ID來限定此選取器，如下所示：

#<containerId>.s7videoviewer

建立互動式設計的CSS

您可以在CSS中針對不同的裝置來設定目標，讓您的內容顯示方式視使用者的裝置而有所不同。 此定位包括但不限於不同的使用者介面元素大小和圖稿解析度。

檢視器支援兩種建立互動式設計CSS的機制：CSS標籤和標準CSS媒體查詢。 您可以單獨使用或搭配使用。

CSS標籤

為協助建立互動式設計的CSS，檢視器支援CSS標籤，這些特殊CSS類別會根據執行時期檢視器大小和目前裝置上使用的輸入類型，動態指派給頂層檢視器容器元素。

第一組CSS標籤包括.s7size_large、.s7size_medium和.s7size_small類。 它們會根據檢視器容器的執行時期區域套用。 即，如果檢視器區域等於或大於一般案頭螢幕的大小.s7size_large;如果區域的大小與普通平板裝置.s7size_medium相近，則會指派此區域。 對於類似行動電話畫面的區域，已設定.s7size_small。 這些CSS標籤的主要用途是針對不同的螢幕和檢視器大小，建立不同的使用者介面版面。

第二組CSS標籤包括.s7mouseinput和.s7touchinput。 .s7touchinput 設定為當前裝置具備觸控輸入功能時；否則， .s7mouseinput 將使用。這些標籤是為不同的輸入類型建立不同螢幕大小的使用者介面輸入元素，因為通常觸控輸入需要較大的元素。 如果裝置同時具備滑鼠輸入和觸控功能，則會設定.s7touchinput，檢視器會轉換適合觸控的使用者介面。

下列範例CSS會在具備滑鼠輸入的系統上，將播放／暫停按鈕大小設定為28 x 28像素，在觸控裝置上則設定為56 x 56像素。 此外，如果檢視器大小變得非常小，則會完全隱藏按鈕：

.s7videoviewer.s7mouseinput .s7playpausebutton { 
    width:28px; 
    height:28px; 
} 
.s7videoviewer.s7touchinput .s7playpausebutton { 
    width:56px; 
    height:56px; 
} 
.s7videoviewer.s7size_small .s7playpausebutton { 
    visibility:hidden; 
}

若要定位像素密度不同的裝置，請使用CSS媒體查詢。 下列媒體查詢區塊將包含高密度螢幕專用的CSS:

@media screen and (-webkit-min-device-pixel-ratio: 1.5) 
{ 
}

使用CSS標籤是建立互動式設計CSS最有彈性的方式，因為它可讓您不僅鎖定裝置螢幕大小，而且鎖定實際的檢視器大小，這對互動式設計頁面版面配置很有用。

使用預設檢視器CSS檔案做為CSS標籤方法的範例。

CSS媒體查詢

裝置感應也可以使用純CSS媒體查詢來完成。 僅當特定媒體查詢區塊在對應裝置上執行時，才會套用其中包含的所有內容。

套用至行動檢視器時，請使用四個CSS媒體查詢，依下列順序定義於CSS中：

1. 僅包含所有觸控裝置的特定規則。

   @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px), 
   only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px) 
   { 
   }
   

2. 僅包含具有高解析度螢幕的平板電腦專屬規則。

   @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px) and (-webkit-min-device-pixel-ratio:1.5), 
   only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px) and (-webkit-min-device-pixel-ratio:1.5)  
   { 
   }
   

3. 僅包含所有行動電話的特定規則。

   @media only screen and (max-device-width:9in) and (max-device-height:9in) 
   { 
   }
   

4. 僅包含高解析度螢幕行動電話的特定規則。

   @media only screen and (max-device-width:9in) and (max-device-height:9in) and (-webkit-min-device-pixel-ratio: 1.5), 
     only screen and (device-width:720px) and (device-height:1280px) and (-webkit-device-pixel-ratio: 2), 
     only screen and (device-width:1280px) and (device-height:720px) and (-webkit-device-pixel-ratio: 2) 
   { 
   }
   

使用CSS媒體查詢方法，您應使用裝置感應來組織CSS，如下所示：

• 首先，案頭特定區段會定義所有特定案頭或所有螢幕通用的屬性。
• 其次，四種媒體查詢應依上述定義的順序進行，並提供特定於對應裝置類型的CSS規則。

在每個媒體查詢中，不需要複製整個檢視器CSS。 只有特定於特定裝置的屬性才會在媒體查詢中重新定義。

CSS精靈

許多檢視器使用者介面元素都使用點陣圖圖樣式化，並有多個不同的視覺狀態。 例如，按鈕通常至少有3種不同狀態："up"、"over"和"down"。 每個狀態都需要為其指定自己的點陣圖圖稿。

使用傳統的樣式設定方法，CSS會針對使用者介面元素的每個狀態，個別參考伺服器上的個別影像檔案。 以下是全螢幕按鈕樣式的範例CSS:

.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='up'] {  
background-image:url(images/v2/PlayButton_up.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='over'] {  
background-image:url(images/v2/PlayButton_over.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='down'] {  
background-image:url(images/v2/PlayButton_down.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][state='disabled'] {  
background-image:url(images/v2/PlayButton_disabled.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='up'] {  
background-image:url(images/v2/PauseButton_up.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='over'] {  
background-image:url(images/v2/PauseButton_over.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='down'] {  
background-image:url(images/v2/PauseButton_down.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='false'][state='disabled'] {  
background-image:url(images/v2/PauseButton_disabled.png);  
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='up'] { 
background-image:url(images/v2/ReplayButton_up.png); 
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='over'] { 
background-image:url(images/v2/ReplayButton_over.png); 
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='down'] { 
background-image:url(images/v2/ReplayButton_down.png); 
} 
.s7videoviewer.s7mouseinput .s7playpausebutton[selected='true'][replay='true'][state='disabled'] { 
background-image:url(images/v2/ReplayButton_disabled.png); 
}

此方法的缺點是，當元素第一次互動時，一般使用者會體驗到使用者介面的閃爍或延遲回應。 發生此動作是因為新元素狀態的影像圖稿尚未下載。 此外，由於伺服器的HTTP呼叫數增加，此方法可能會對效能造成輕微的負面影響。

CSS精靈是另一種方式，可將所有元素狀態的影像圖稿結合為稱為「精靈」的單一PNG檔案。 此類「精靈」具有指定元素的所有視覺狀態，並依序放置。 當使用精靈設定使用者介面元素的樣式時，CSS中所有不同狀態都會參照相同的精靈影像。 此外，background-position屬性會用於每個狀態，以指定使用"sprite"影像的哪一部分。 您可以以任何適當的方式來建構「精靈」影像。 檢視器通常會垂直堆疊檢視器。 以下是以「精靈」為基礎的範例，說明上方相同全螢幕按鈕的樣式：

.s7videoviewer .s7fullscreenbutton[state][selected]{ 
 background-image: url(images/v2/FullScreenButton_dark_sprite.png); 
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='up'] {  
background-position: -84px -1148px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='over'] {  
background-position: -56px -1148px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='down'] {  
background-position: -28px -1148px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='true'][state='disabled'] {  
background-position: -0px -1148px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='up'] {  
background-position: -84px -1120px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='over'] {  
background-position: -56px -1120px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='down'] {  
background-position: -28px -1120px;  
} 
.s7videoviewer.s7mouseinput .s7fullscreenbutton[selected='false'][state='disabled'] {  
background-position: -0px -1120px;  
}

一般樣式注意事項與建議

• CSS內外部資產的所有路徑都會根據CSS位置而非檢視器HTML頁面的位置來解析。 將預設CSS複製至不同位置時，請記得考量此規則。 複製自訂CSS中的預設資產或更新路徑。

• 點陣圖圖稿的偏好格式為PNG。

• 使用background-image屬性將點陣圖圖稿分配給用戶介面元素。

• 用戶介面元素的width和height屬性定義其邏輯大小。 傳遞給background-image的點陣圖的大小不會影響邏輯大小。

• 若要使用高像素密度的高解析度螢幕（例如Retina），請指定點陣圖圖稿的大小是邏輯使用者介面元素大小的兩倍。 然後，應用-webkit-background-size:contain屬性，將背景縮小到邏輯用戶介面元素大小。

• 若要從使用者介面移除按鈕，請將display:none新增至其CSS類別。

• 您可以針對CSS支援的色彩值使用各種格式。 如果需要透明度，請使用rgba(R,G,B,A)格式。 否則，可使用格式#RRGGBB。

• 使用CSS自訂檢視器使用者介面時，不支援使用!IMPORTANT規則來設定檢視器元素的樣式。 尤其是，!IMPORTANT規則不應用來覆寫檢視器或檢視器SDK提供的任何預設或執行時期樣式。 其原因在於，它可能會影響正確組分的行為。 您應該改用具有適當特殊性的CSS選擇器來設定本參考指南中說明的CSS屬性。

常用用戶介面元素

以下是適用於視訊檢視器的使用者介面元素參考檔案：