[匯入][翻譯]JW Media Player中文文檔

官方網址 http://www.jeroenwijering.com

這篇文檔包含了JW MP3 Player,JW FLVPlayer,JW Media Player,JW Image Rotator的安裝方法和配置方
法

JW PLAYERS 3.11 文檔

1，安裝 （在你的網站裡嵌入）
2，參數 （配置）
    基本參數
    顏色參數
    介面參數
    播放參數
    互動參數
3，播放清單
4，自訂
5，支援

快速配置，可回合組態嚮導 

1，安裝
下載後，你可以得到一個例子，當用文本或HTML編輯器開啟的時候，你可以發現swf是用一段短小的
javascript嵌入到頁面上的。這個Javascript是Geoff Stearns寫的swfobject.js，它解決了Flash需要激
活的麻煩。當複製swf到你的網站的時候，不要忘記了把swfobject.js一同複製過去。並且在頁面中的
Head中加入下面代碼

程式碼<script type="text/javascript" src="swfobject.js"></script>

在swfobject.js的協助下你可以方便的設定swf的路徑，寬度，高度，背景顏色和所需要的Flash播放器的版本，也可以通過它設定一組參數來配置swf。當頁面載入的時候，javascript會根據id來替換頁面中的節點。

程式碼<p id="player"><a href="http://www.macromedia.com/go/getflashplayer">Get Flash</a> to see this player.</p>
<script type="text/javascript">
    var so = new SWFObject('mediaplayer.swf','player','400','400','7');
    so.addParam("allowfullscreen","true");
    so.addVariable("file","test.flv");
    so.addVariable("displayheight","300");
    so.write('player');
</script>

在你不能使用javascript的情況下（比如你的bsp不支援，如myspace），你可以使用"embed"的方式來插入swf。
需要注意的是 swf可以不在該伺服器上，但是如果你需要用xml的播放清單可能會有問題，因為xml必須和swf在同一個伺服器上，否則會因為安全問題被組織。mp3，jpg，flv可以不在該伺服器上。

程式碼<embed src="http://www.myfileserver.com/folder/mediaplayer.swf" width="400" height="400" 
type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" 
flashvars="file=http://www.myfileserver.com/folder/test.flv&displayheight=300" />

2，參數
這些參數可以配置被嵌入到html中的播放器的行為和外觀。如果使用swfobject.js，可以用addVariable()方法來配置，如果使用的embed方式，可以通過定義"flashvars"屬性來組態變數，注意用"&"符號分割這些變數。

被*號標註的同樣適用於 JW Image Rotator

基本變數

displayheight(number）：顯示地區的高度.控制地區最小高度是20px，當該值大於或等於swf的高度時，播放清單會自動隱藏，否這會顯示。
file*(url）：要播放檔案的地址。 支援單檔案播放(MP3/FLV/RTMP/JPG/SWF/PNG/GIF)，也支援播放清單。JW Image Rotator只支援列表
height*(number）：設定swf的高度，當使用embed方式插入的時候，在embed的屬性裡已經設定了。但是有時候（特別是使用IE的時候）高度會變的不確定，影響了布局，這時候需要通過該參數設定下，該值的單位是px
image(url）:當你播放mp3，flv的時候，你可以通過該值設定一個預覽圖作為專輯封面，支援 JPG/SWF/PNG/GIF file. 你也可以在播放清單中對每一項進行設定。
shownavigation*（true,false):該參數僅被JW Image Rotator支援。用來顯示或隱藏圖片導航。
transition* (fade,bgfade,blocks,bubbles,circles,fluids,lines,random,slowfade): 該參數僅被JW Image Rotator支援。用來設定圖片替換的效果。 設定為"random" 將隨機的設定效果.預設值為 "fade". 
width*(number):設定swf的寬度，其他同height；

顏色變數

backcolor*(color):設定播放器的背景顏色。JW Media Player等預設為 0xFFFFFF (白色) JW Image Rotator預設為  0x000000 (黑色). 
fontcolor*(color):設定文字和按鈕的顏色。JW Media Player等預設為 0x000000 (黑色) JW Image Rotator預設為  0xFFFFFF (白色). 
lightcolor*(color):設定被被啟用狀態的顏色。JW Media Player等預設為 0x000000 (黑色) JW Image Rotator預設為  0xCC0000 (紅色). 

介面參數

autoscroll(true,false):當播放清單過長的時候，預設會自動顯示捲軸。當該值設定為'true'的時候，會自動根據滑鼠滾動播放清單。
displaywidth(number of pixes):設定顯示地區的寬度，當設定的比較小的時候，播放清單會顯示在顯示地區的右側而不是底部。
kenburns* (true,false): 用以實現在運動的時候實現kb效果（Ken Burns effect），注意，當圖比較大，而且網速比較快的時候，建議開啟，否則關閉。建議設定transition為"slowfade"來配合。
largecontrols (true,false): 設定該值為true用來放大控制地區的按鈕。建議為視力不好的使用者開啟
logo* (url): 設定一個圖片用來作為右上方的浮水印，支援所有圖片格式，支援通明圖層的png效果最佳。
overstretch* (true,false,fit,none): 設定圖片/影片在顯示地區的縮放。"true"等比例展開用來符合顯示地區。"false"僅展開合顯示地區。"fit"全螢幕顯示。"none"顯示原始大小。JW Media Player等預設為"fit",JW Image Rotator預設為"false"
showdigits (true,false,total): 設定為"false"隱藏播放時間等資訊用來節省控制地區的空間。設定為"total"用來顯示全部時間。
showdownload (true,false):設定該值用來在控制地區顯示下載按鈕。連結到link所設定的地址。
showeq (true,false): 用來顯示一個假的音頻波動效果。當播放mp3的時候打設定該值可以得到很好的效果
showicons* (true,false): 用來顯示或者隱藏顯示地區中間的圖片，JW Media Player等預設為true。JW Image Rotator預設為false；
showvolume (true,false): 用來設定是否顯示音量控制按鈕
thumbsinplaylist (true,false): 設定列表中是否顯示預覽圖

播放參數
autostart (true,false,muted): 設定為ture，頁面載入完後會自動播放。設定為muted，會在靜音下自動播放，並且顯示地區中間有靜音表徵圖。
bufferlength (number): 設定flv的緩衝時間。預設為3秒
repeat* (true,false,list): 預設為flase，從當前播放位置播放至列表尾部後停止。設定為list會播放清單中所有的項目，設定為true會迴圈播放。
rotatetime* (number): 設定圖片的顯示時間。JW Media Player等預設為10秒,JW Image Rotator預設為5秒
shuffle* (true,false): 設定為false順序播放，設定為true無序播
smoothing (true,false): 設定為false關閉視頻平滑處理，推薦設定true用以得到更好效果。但對於大螢幕或者配置低的機器設定false是有好處的
start* (second): 在使用RTMP 或 HTTP 流媒體的時候（非常規的flv/mp3)，使用該變數準確的定位開始位置。該參數設定在XSPE格式的列表中以便准且的設定檔案的章節。
volume* (number): 設定音量，預設為80.

互動參數

audio* (url):用這個參數來添加一個mp3檔案作為單獨的音頻，可以作為圖片的背景音樂解說等。
bwfile (url):用以頻寬檢測的檔案的地址，可以放一個圖片，或者rtmp流媒體。可以在右鍵菜單中查看到貸款數值。 
bwstreams (comma-separated list of bitrates):
和bwfile配合使用，根據頻寬值來選擇不同的檔案。如：你要播放video.flv並且設定該項的值為100,250,500,1000,當播放器發現頻寬為349kbps的時候，將會播放video_250.flv。所以他有一套有效命名設定，他將會自動切換，哪怕是在採用播放清單的情況下。
callback (url):設定這個參數為服務端程式（php/asp)地址用來回傳資料。在每個項播放和停止的時候會發送資料到伺服器，以便在伺服器端儲存播放統計。
captions (url): 設定該值用以載入一個文字格式設定的文本作為字幕。播放器至支援SMIL格式和DVD的SRT格式的字幕。如果你的flv檔案內建字型你可以設定該值為"captionate".如果你有多頻道字幕，可以設定這個值為"captionate0", "captionate3"等。可以在列表中設定每一個項的值。
enablejs* (true,false): 設定為true開啟對javascript的支援。僅支援線上使用。javascript可以控制播放，載入媒體，獲得當前播放項的詳盡資訊。
fsbuttonlink (url):如果使用者的flashplayer版本高於（9.0.28）播放器會自動的顯示一個全屏按鈕。通過設定該值，你可以連結到另外的頁面用以全螢幕顯示。服務端程可以設定將要播放的檔案。
id (string): 播放器的唯一標識。將會被回傳到伺服器端。
javascriptid* (string):如果你的頁面上有多個播放器，你可以設定這個參數給每個播放器不同的id，這樣就可以方便的用javascript來控制。他將回傳到getUpdate（）事件中。
link (url): 通過這個參數用來設定一個可現在的版本，或者強制使用者通過該地址下載當前項。可以在播放清單中為每一項設定該值。
linkfromdisplay* (true,false):設定顯示地區被點擊時要訪問的頁面。預設點擊顯示地區時會進行播放/暫停操作。
linktarget* (frame): 設定連結目標，"_self"在當前頁開啟。"_blank"在新頁面中開啟。
streamscript (url):設定這個參數為了相容‘偽流媒體’FLV檔案。
type (mp3,flv,rtmp,jpg,png,gif,swf,rbs,3gp,mp4,m4v): 播放器會根據檔案名稱的最後三個字元來判斷類型。在你使用伺服器端語言進行重新導向時，這種方法將不會再有效。所以你可以設定這個參數來告訴播放器檔案類型。你也可以在播放清單中對每一項進行設定。如果播放器找不到檔案類型將會被識別為播放清單。
useaudio (true,false): 設定為false用來改變為靜音狀態。
usecaptions (true,false):設定為false隱藏字幕. 
usefullscreen (true,false):如果你不希望用flashplayer9的全螢幕模式。可以設定"fsbuttonlink"參數用來替換全屏按鈕的事件。
usekeys (true,false): 設定為"false"用來取消鍵盤操作(SPACE,UP,DOWN,LEFT,RIGHT)

注意：你必須對?=&進行字元轉移。? → %3F, = → %3D, & → %26. 你的"file" 變數為getplaylist.php?id=123的時候必須設定為 getplaylist.php%3Fid%3D123.

播放清單

當播放清單中只有一個項目的時候，播放器會用單檔案播放模式進行播放。播放器根據檔案名稱來區分單檔案和播放清單檔案。如你的負載檔案名為test.mp3的檔案，播放器會用單檔案播放模式去播放mp3，因為副檔名是mp3.如果你的檔案名稱是getlist.php,播放器會認為這是個播放清單。如果你使用了動態指令碼來載入一個單檔案如

播放器支援三種常用的播放清單格式來確保通用性。XSPF，RSS和ATOM。

播放器所支援的XSPF/RSS/ATOM列表的通用標籤。
表格

*Image Rotator僅支援播放清單中的第一個'audio'項，被用來做為背景音樂來播放。播放器會播放所有的音樂項目。

** "category" 元素可以用來支援廣告。你可以設定該值為"preroll", "postroll" 或 "overlay". 
使用"link"播放清單中單項的值為廣告地址。

*** "start"元素只被XSPF的播放清單格式支援。該元素用來設定流媒體檔案（HTTP or RTMP)的開始位置，單位為秒。

**** XSPF列表格式中的"location"元素中如果不包含常見的副檔名(如 "mp3" or "flv"),可以使用"meta"元素指定檔案格式。(如 <meta rel='"type">mp3</meta> ).在使用RSS和ATOM的情況下,檔案格式被自動的根據mimetype來識別。 

RTMP streams, the additional "id" flashvar has to be sent as well. Example: "file=rtmp://my.streaming.server/mypath" and "id=video_one".

注意，當你播放單檔案的時候，你支援所有的參數,如你可以添加一個image，title，id，link等。如當你用單檔案播放模式播放"video.flv"時你也想添加一個預覽圖，你可以設定參數"file=video.flv","image=preview.jpg".當你播放RTMP流媒體的時候，你可以添加參數"id".如"file=rtmp://my.streaming.server/mypath" ，"id=video_one".

特別指出兩個容易出錯的地方。第一列表必須和播放器在同一個伺服器上，這是flash的安全機制導致的。第二，要使用完整的地址格式包含http，以免播放器找不到檔案。

自訂
有人多人要求我建立一些可自訂的版本。他們的很多要求其實已經可以通過設定參數來實現了。我做了一個線上設定精靈可以簡單的配置這些參數。我沒有精力去滿足所有人的要求。不過在下一個版本中會有很多有趣的附加功能。

如果你熟悉actionscript指令碼語言，你可以自己修改程式添加功能。

播放器在執行個體的時候會最近會加完配置和播放清單變數，然後進入MCV的生命週期。在MCV生命週期中，配置和清單管理員（feeder）始終是有效。

紅色標註的兩個對象的所有方法可以通過javascript調用。

在另外的flash程式中是可以引用播放器的。只要從下載的flv檔案中複製出映像到你的flv中，並且確保將下載的com目錄複寫到你的flv檔案中，裡麵包含了所有的指令碼。然後你就可以在時間軸的第一個幀的位置訪問變數了。注意要設定高度和寬度的變數，否則播放器會根據你的尺寸展開變形。
如 程式碼// Set the flashvars (booleans and numbers should also be quoted)
var width = "320";
var height = "240";
var file = "my_video.flv";
var autostart = "true";
// Start the player
var mpl = new com.jeroenwijering.players.MediaPlayer(this.player);
Additionally, I have made the controller a public object, so you can control the mediaplayer with the sendEvent() function from anywhere in your flash site (the schematic above has a list of all sendEvent() options). Let's continue the small script above:

我為播放器建立了公開的controller對象，所以你可以在你程式的任何地方通過使用sendEvent（）來控制播放器，如：

程式碼mpl.controller.sendEvent("volume",50);
mpl.controller.sendEvent("playpause");

支援

常見問題列表

1.如果你在使用ie的情況下出現了布局錯亂的情況，那可能是大小沒有別設定好，你可以使用變數"width"和"height"來強行設定。
2.注意，flash和javascript的安全機制會影響你的本地測試。當你的檔案放在不同的伺服器上的時候也會受到影響，你可以嘗試放在同一個伺服器上。
3.全屏功能只有在flash player9.028.0以上版本才能使用，如果你使用了swfobject來嵌入你的播放器，你可以使用他的自動升級功能。注意設定 "allowfullscreen" 為true
4.如果你的進度條不動，或者你的視頻的長度有問題。那可能是你的flv沒有設定正確的metadata。你可以使用一個小工具www.buraks.com/flvmdi/. 

文章來源:http://onewww.net/blog/default.asp?id=98