swfなmp3プレーヤであるDewplayerをアイテム中・スキン中に展開するプラグインです。

このプラグインには不具合が潜在している可能性があります

DewplayerはフランスのDew氏( http://www.estvideo.com/dew/ )によって作られたswf製のmp3プレーヤで著作権はDew氏にあり、クリエイティブ・コモンズの「帰属 - 同一条件許諾ライセンス (by-sa) フランス版」( http://creativecommons.org/licenses/by-sa/2.0/fr/deed.ja )に準拠します。

現在のバージョン0.0.2.2(beta)ではDewplayer 1.5に対応しています。

バージョン1.5のDewplayer、4タイプを展開することが可能です。

• normalタイプ
  • dewplayer.swf
  • 通常のDewplayerです。
• miniタイプ
  • dewplayer-mini.swf
  • 通常のDewplayerに比べて表示サイズが小さなタイプです。
• multiタイプ
  • dewplayer-multi.swf
  • 複数のなかから再生するファイルをユーザーが切り替えることが可能です。
• volumeタイプ
  • dewplayer-vol.swf
  • ユーザーがボリュームをコントロールすることができるタイプです。

1. zipファイルを展開して、中身をサーバーのプラグインディレクトリにアップロードする
2. 管理画面からプラグインをインストールする
3. ここからDewplayerをダウンロードし、mediaディレクトリにアップロードする
   • 4タイプありますが、使用するタイプ以外は不要です。タイプについては別記しています。
   • アップロード先はプラグインのオプションで指定可能です。オプションについては別記しています。

1. ver.0.0.0からバージョンアップする場合は一度アンインストールした後に再インストールする必要があります。

スキン・アイテム・テンプレートに特定の文字列を記述することでその場に展開されます。記述する内容についてはスキン/テンプレートへの記述を参照してください。

<%Dewplayer(''ファイル名''[,パラメータ[,パラメータ...]])%>

スキン変数<%Dewplayer%>についてのパラメータについて説明します。同様の内容でテンプレート中、アイテム中に記述することができます。

• 最初のパラメータはファイルのパスで、必須です。
  • 記述方法はアイテム中で使用できる<%image%>等と同様で、コレクション/ファイルの形で記述します。
    • アイテム中/テンプレート中でアイテムの作者のプライベートコレクションを参照する場合はコレクション名を省略できます。
      • たとえばメンバーIDに1をもつメンバーがアイテム中に<%Dewplayer(test.mp3)%>と記述した場合は、mediaディレクトリ/1/test.mp3が参照されます。
      • スキンに記述する場合にはコレクション名の省略を利用できません。
      • テンプレート中でのコレクション名の省略はver.0.0.1以降で有効です。
  • <%image%>と異なり、http:ではじまる絶対URLを指定することができます。 * |で区切ることで複数ファイルを指定することができます。multiタイプのプレーヤのみ有効です。 * ,を含むファイル名は指定できません。仕様です。 * 二番目以降のパラメータは順不同で、省略可能です。同一の事柄について複数の指定がある場合は、最後のもののみが有効になります。 * normal / mini / multi / volumeは展開するDewplayerのタイプです。 * volume=xxxは再生するボリュームです。単位はパーセントで、100までの値が有効です。 * autostart / noautostartはロード後に自動で再生するかどうかの設定です。 * autostartが指定されている場合はロード後に自動で再生されます。 * noautostartが指定されている場合は自動で再生されません。 * autoreplay / noautoreplayは最後まで再生した後、自動で始めから再生しなおすかどうかの設定です。 * autoreplayが指定されている場合は自動で始めから再生しなおします。 * noautoreplayが指定されている場合は自動で始めから再生しなおしません。 * showtime / noshowtimeは音声の長さ、経過時間を表示するか否かです。 * showtimeを指定すると音声の長さや経過時間が表示されます。 * ファイルによっては表示されない場合もあります。 * noshowtimeを指定すると時間以外で長さや経過が表示されます。 * bgcolor=xxxxxxは背景色の指定です。 * HTMLやCSSのカラーコード同様、6桁の16進数で指定します。 ====javascriptのロード==== この機能はver.0.0.2.2以降で有効です スキンで、HTMLのhead要素内に<%Dewplayer(javascript)%>と記述すると、その場に<script …></script>タグが出力され、表示時に専用のjavascriptがロードされます。 この記述を行うと以降でswfを読み込む部分にjavascriptによるロード機能が付加され、IEでの問題に対応することが出来ます。 この記述を行わない場合はjavascriptを利用しないコードでswfを読み込みます。その場合、IEではユーザにクリックを促すメッセージが表示されます。 この機能は特にテストが不十分です。 ====<%media()%>の置換==== この機能はver.0.0.2以降で有効です オプションでReplace media()を『はい』にすると、拡張子がmp3であるファイルが指定された<%media()%>がこのプラグインの置換対象になります。 <%media()%>を置換する場合は最初のパラメータにファイルを、二番目のパラメータ(代替テキスト)に他のオプションを指定します。つまり、 <%media(xxx.mp3|mini,autostart)%> は <%Dewplayer(xxx.mp3,mini,autostart)%> と同等に解釈されます。 <%media()%>の置換では複数ファイルを指定することが出来ませんので注意してください。 =====オプション===== * URL for Dewplayer (normal) * URL for Dewplayer (mixi) * URL for Dewplayer (multi) * URL for Dewplayer (volume) * Dewplayer本体のURLです。デフォルトではmediaディレクトリ直下にDewplayerは置かれています。 * Type (default) * Volume (default) * Auto-start (default) * Auto-repeat (default) * Show time (default) * Background-color (default) * スキン変数のパラメータ省略時の初期値です。 * Replace media() * 『はい』にすると<%media()%>の置換が有効になります。 =====Tipsと裏技===== =====希望事項===== =====バグ===== * Dewplayerの存在・再生するファイルの存在ともに、このプラグインは一切チェックしていません。 =====開発履歴===== * ver.0.0.2.2 リリース <2006/12/07> * <%Dewplayer(javascript)%>の記述がなかった場合にjavascriptを使わないコードを出力するように修正 * ver.0.0.2.1 リリース <2006/12/04> * IEブラウザブロックの回避　<%Dewplayer(javascript)%>の記述を追加 * ver.0.0.0 リリース <2006/07/04> * 最初の更新 =====参考プラグイン===== * NP_FlashMP3 ( http://wakka.xiffy.nl/flashmp3 ) * 同じくDewplayerを使ったプラグイン * NP_Fmovie ( http://www.fukulog.com/NP_Fmovie.html ) * .flv形式のムービーを埋め込むプラグイン * NP_FlashVideo ( http://wakka.xiffy.nl/flashvideo ) * .flv形式のムービーを埋め込むプラグイン