<Object>
で構成され、<Embed>
タグがネストされたHTMLブロックを挿入します。このHTMLブロックは、OracleデータベースにinterMediaオブジェクトとして格納されたメディア・コンテンツをレンダリングします。
JSP構文
<jbo:EmbedAudio
datasource="datasourceInstanceName"
mediaattr="mediaAttributeName"
[[ rowkey="rowKeyString" ] | [ whereclause="whereClause" ]]
[ retrievepath="customRetrievePath" ]
[ width="pluginWidth" ]
[ height="pluginHeight" ]
[[ alt="alternateText" ] | [ altattr="alternateAttributeName" ]]
[ title="advisoryTitle" ]
[ helperapp=" WindowsMediaPlayer | QuickTimePlayer | RealMediaPlayer" ]
[ showcontrols="showControls" ]
[ autoplay="autoStart" ]
[ loop="loopPlay" ]
[ standby="standbyText" ]
/>
説明
<jbo:EmbedAudio>
データ・タグを使用すると、ActiveXコントロールやプラグインなどのヘルパー・アプリケーションを使用しているブラウザに組み込んで、データベースにinterMediaオブジェクトとして格納されたメディア・コンテンツを再生できます。使用するヘルパー・アプリケーション、そのヘルパー・アプリケーションの高さと幅、およびその他の属性を指定できます。
現在、<jbo:EmbedAudio>
データ・タグをサポートするヘルパー・アプリケーションは、次の3つのみです。
生成されたHTMLコードとは、ネストされた<EMBED>
タグがある<OBJECT></OBJECT>
ブロックです。<jbo:EmbedAudio>
データ・タグを使用するJSPページは、Microsoft Internet Explorerでは正常に起動しますが、Netscape Navigatorでは失敗する場合があります。これは、Netscapeで<OBJECT>
タグがサポートされておらず、<EMBED>
タグに制限があるためです。Netscapeブラウザでは、<OBJECT>
タグを完全にサポートしないため、通常、<OBJECT>
タグを無視し、ネストされた<EMBED>
タグを使用します。<EMBED>
タグには、使用する完全なプラグインを指定する方法がないという既知の制限事項があります。プラグインの起動は、NetscapeブラウザのプラグインのアソシエーションおよびMIMEタイプに純粋に依存します。
このタグは、<jbo:Row>
または<jbo:RowsetIterate>
データ・タグ内にネストできます。このタグがこの2つのタグのいずれかに使用された場合、これらのタグで定義された行が使用され、rowkey
属性およびwhereclause
属性は無視されます。このタグが使用されない場合、このタグでは行の検索にrowkey
属性またはwhereclause
属性が使用されます。rowkey
はwhereclause
よりも優先されます。どちらの属性も指定しない場合、このタグではデータソース・オブジェクトの現在の行が使用されます。<jbo:RowsetNavigate>
データ・タグを使用して、データソース・オブジェクトの現在の行を変更できます。
[mediaFetchingURL]
の書式は次のとおりです。
[retrievepath]?appModId=[appModId]&rowSetName=[rowSetName]&contentCol=[mediaAttributeName]&rowKey=[rowKeyString]
デフォルトにより、[retrievepath]
は、あらかじめ提供されているordPlayMedia.jsp
というJSPページです。独自のメディア配信コンポーネントを記述し、こうした要件が生じた場合に独自の検索パスを指定できます。
属性
datasource: interMediaオブジェクトにアクセスするために使用するデータソースID。データソースは、<jbo:DataSource>
データ・タグを使用して作成します。
mediaattr: interMediaオブジェクトを含む、(データソース内の)特定のビュー・オブジェクト属性の名前。
rowkey: (オプション)行を一意に識別するために使用する行識別子のテキスト・エンコーディング。
whereclause: (オプション)行の場所を一意に特定する問合せのWHERE句。
retrievepath: メディア・コンテンツ転送コンポーネントのカスタム取得パス。デフォルト値はordPlayMedia.jsp
です。
width: オプション。ヘルパー・アプリケーションの幅。デフォルトは300
です。
height: オプション。ヘルパー・アプリケーションの高さ。デフォルトは200
です。
alt: オプション。メディア・コンテンツのレンダリングがブラウザでサポートされていない場合の代替テキスト。altattr
属性が指定されている場合、この属性は使用できません。
altattr: オプション。代替テキストを含む属性の名前。alt
属性が指定されている場合、この属性は使用できません。
title: オプション。付加情報タイトル。
helperapp: オプション。サポートされているブラウザのヘルパー・アプリケーションの名前(WindowsMediaPlayer
、QuickTimePlayer
およびRealMediaPlayer
)。この属性を指定しない場合、または不明な文字列を使用して指定した場合、デフォルトのヘルパー・アプリケーションWindowsMediaPlayer
が使用されます。
showcontrols: オプション。ヘルパー・アプリケーションのコントロール・コンポーネントの表示の有無。有効値はtrue
およびfalse
です。デフォルトはtrue
です。
autoplay: オプション。メディア・コンテンツのレンダリングの自動実行の有無。有効値はtrue
およびfalse
です。デフォルトはtrue
です。
loop: オプション。メディア・コンテンツのレンダリングのループの有無。有効値はtrue
およびfalse
です。デフォルトはfalse
です。
standby: オプション。データのロード中の待機メッセージ。
例1:
<jbo:EmbedAudio datasource="ds" mediaattr="Clip" whereclause="id = 5" />
HTML出力
<OBJECT CLASSID="clsid:22D6F312-B0F6-11D0-94AB-0080C74C7E95" HEIGHT="200" WIDTH="300" CODEBASE="http://activex.microsoft.com/activex/controls/mplayer/en/nsmp2inf.cab#Version=5,1,52,701" >
<PARAM NAME="FileName" VALUE="[mediaFetchingURL]">
<PARAM NAME="AutoStart" VALUE="true">
<PARAM NAME="ShowControls" VALUE="true">
<EMBED SRC="[mediaFetchingURL]" HEIGHT="200" WIDTH="300" PLUGINSPAGE="http://www.microsoft.com/isapi/redir.dll?prd=windows&sbp=mediaplayer&ar=Media&sba=Plugin&" AutoStart="true" ShowControls="true" >
</EMBED>
</OBJECT>
例2:
<jbo:RowsetNavigate datasource="ds" action="First" />
<jbo:EmbedAudio datasource="ds" mediaattr="Clip" helperapp="q_player" autoplay="false" alt="My favorite song." />
HTML出力
<OBJECT CLASSID="clsid:02BF25D5-8C17-4B23-BC80-D3488ABDDC6B" HEIGHT="200" WIDTH="300" CODEBASE="http://www.apple.com/qtactivex/qtplugin.cab" >
<PARAM NAME="SRC" VALUE="[mediaFetchingURL]">
<PARAM NAME="HEIGHT" VALUE="200">
<PARAM NAME="WIDTH" VALUE="300">
<PARAM NAME="AUTOPLAY" VALUE="false">
<PARAM NAME="CONTROLLER" VALUE="true">
<PARAM NAME="LOOP" VALUE="false">
<EMBED SRC="[mediaFetchingURL]" TYPE="video/quicktime" HEIGHT="200" WIDTH="300" AUTOPLAY="false" CONTROLLER="true" LOOP="false" PLUGINSPAGE="http://www.apple.com/quicktime/download/" >
</EMBED>
<NOEMBED>お気に入りの曲</NOEMBED>
</OBJECT>
Copyright © 1997, 2009, Oracle. All rights reserved.