前 次

第 3 章: メソッド

アプリケーション、アプレット、またはコントロールは、次のメソッドを使用して RealPlayer G2 と通信することができます。メソッドのデータ タイプについては、RealPlayerフォルダ内にインストールされている rpcl3260.zip ファイルの RAPlayer.java を参照してください。RealPlayer 5.0 は、「RealPlayer 5.0 との互換性」 で説明されている特定のメソッドをサポートします。

再生コマンド

DoPlay()

現在のクリップを再生します。[再生] ボタンをクリックした場合と同じです。

CanPlay()

TRUE または FALSE を返します。プレーヤーが現在一時停止または停止していて、現在のソース ファイルが有効であれば、TRUE を返します。

DoStop()

クリップを停止します。[停止] ボタンをクリックした場合と同じです。このメソッドは、RealPlayer 5.0 と上位互換性があります。

CanStop()

RealPlayer が現在クリップを再生している場合、または一時停止している場合に、TRUE を返します。このメソッドは、RealPlayer 5.0 と上位互換性があります。

DoPause()

現在のクリップを一時停止します。[一時停止] ボタンをクリックした場合と同じです。

CanPause()

プレーヤーが現在クリップを再生している場合に、TRUE を返します。

CanPlayPause()

プレーヤーが現在、再生、一時停止、または停止していて、現在のソース ファイルが有効である場合に、TRUE を返します。RealPlayer 5.0 と上位互換性があります。RealPlayer G2 のみをサポートしている場合には、CanPause() および CanPlay() を代わりに使用してください。

DoPlayPause()

現在のクリップを再生または一時停止します。RealPlayer 5.0 と上位互換性があります。RealPlayer G2 のみをサポートしている場合には、DoPause() および DoPlay() を代わりに使用してください。

再生状態の情報

GetPlayState()

RealPlayer の現在の状態を返します。値は数値で、それぞれの意味は次のとおりです。


0 停止中 
 1 接続中 
 2 バッファリング中
 3 再生中
 4 一時停止中 
 5 検索中

GetBufferingTimeElapsed()

バッファリングの経過時間をミリ秒単位で返します。

注意
GetBufferingtimeElapsed() メソッドは現在サポートされていません。 これは、次のリリースでサポートする予定です。

GetBufferingTimeRemaining()

残りのバッファリング推定時間をミリ秒単位で返します。

属性

GetPreFetch()

PreFetch が使用可能かどうかを返します。

SetPreFetch()

PreFetch 再生モードを使用可能/使用不可にします。有効な値は TRUE および FALSE です。デフォルトは FALSE です。

補足情報
｢<EMBED> による PREFETCH の使用｣ または ｢<OBJECT> による PREFETCH の使用｣を参照してください。

GetControls()

コントロールのビジュアル コンポーネントを返します。

補足情報
有効なコントロール名については、http:// service.real.com/help/library/index.html にある 『RealSystem G2 Production Guide』 の Web ページ再生に関する章を参照してください。

SetControls()

コントロールのビジュアル コンポーネントを設定します。RealPlayer G2 とのみ互換性があります。

SetControlString()

コントロールのビジュアル コンポーネントを設定します。メソッドは SetControls() と同一ですが、RealPlayer 5.0 Netscape プラグイン (5.0 ActiveX コントロールではありません) と互換性があります。RealPlayer G2 のみをサポートしている場合には、SetControls() を代わりに使用してください。

GetConsole()

複数のコントロール インスタンスのリンクに使用されているコンソール名を返します。リンクするコントロールのインスタンスごとに、この関数を一度呼び出してください。

SetConsole()

複数のコントロール インスタンスのリンクに使用されるコンソール名を設定します。リンクするコントロールのインスタンスごとに、この関数を呼び出してください。同じコンソール名を持つすべてのコントロールは同時に機能します。たとえば、同じページに [再生] および [停止] ボタンが複数ある場合、コンソール名を共有することにより、各ボタンが同じクリップをコントロールできます。コンソール名 _master はすべてのインスタンスにリンクします。コンソール名 _unique はその他のインスタンスにリンクしません。

SetConsoleName()

機能的には SetConsole() と同一ですが、RealPlayer 5.0 Netscape プラグイン (5.0 ActiveX コントロールではありません) と上位互換性があります。RealPlayer G2 のみをサポートしている場合には、SetConsole() を代わりに使用してください。

SetAutoStart(boolean autoStart)

ソース データが使用可能になったときにコントロールが自動的に再生を開始するかどうかを設定します。有効な値は、TRUE および FALSE です。このメソッドは、RealPlayer 5.0 Netscape プラグインと互換性があります。ActiveX コントロールとは互換性がありません。

GetAutoStart()

再生が自動的に開始するかどうかを返します。.

SetAutoGoToURL()

URL の処理方法を設定します。このメソッドは、RealPlayer 5.0 と上位互換性があります。有効な値は以下のとおりです。

GetAutoGotoURL()

AutoGotoURL プロパティが使用可能かどうかを返します。

DoGoToURL(url, target)

RealPlayer 5.0 および G2 ActiveX コントロールの場合、このメソッドを使用すると、指定したフレーム ターゲット内の URL に制御が移動されます。コンテナが URL ブラウジングをサポートしている必要があります。パラメータは以下のとおりです。


string URL

string target

SetLoop()

クリップがループするかどうか指定します。有効な値は、TRUE (再生が割り込まれるまでループします) および FALSE (デフォルト) です。

GetLoop()

クリップがループするように設定されているかどうかを返します。

SetNumLoop()

クリップがループする回数を設定します。パラメータとして整数を取ります。

GetNumLoop()

SetNumLoop() 内で設定されているループ回数を返します。

SetCenter()

ビジュアル データ タイプが、イメージ ウィンドウ内で自然なサイズでセンタリングされるかどうかを設定します。有効な値は TRUE および FALSE (デフォルト) です。

GetCenter()

ビジュアル データ タイプがイメージ ウィンドウ内でセンタリングされるかどうかを返します。有効な値は、TRUE および FALSE です。

SetMaintainAspect()

イメージ ウィンドウを拡大したときに、ソースの縦横比を維持します。有効な値は TRUE および FALSE (デフォルト) です。

GetMaintainAspect()

ビジュアル データ タイプの縦横比が維持されるかどうかを返します。

SetBackgroundColor()

イメージ ウィンドウ コントロールの背景色を指定します。有効な値は、#RRGGBB 形式の RGB 16 進カラー値か、または次のカラー名です。ここでは、カラー名に対応する RGB 値も示します。

白 (#FFFFFF)銀 (#C0C0C0)灰色 (#808080)黒 (#000000)
黄 (#FFFF00)赤紫 (#FF00FF)赤 (#FF0000)栗 (#800000)
ライム (#00FF00)オリーブ (#808000)緑 (#008000)紫 (#800080)
アクア (#00FFFF)青緑 (#008080)青 (#0000FF)濃紺 (#000080)

GetBackgroundColor()

現在の背景色の 16 進値を返します。

SetNoLogo()

イメージ ウィンドウ コントロール内に RealLogo を表示するかどうか決定します。イメージ ウィンドウのデフォルトは、背景色が指定されている場合を除き、黒です。有効な値は TRUE および FALSE (デフォルト) です。

GetNoLogo()

RealLogo がイメージ ウィンドウに表示されるかどうかを返します。

SetNoLabels()

RealPlayer 5.0 のコントロール ウィンドウ内にタイトル、著者、および著作権のラベル テキストを表示しないようにします。コンテンツ文字列は表示されます。このメソッドは RealPlayer G2 に影響がありませんが、互換性はあります。

GetNoLabels()

タイトル、著者、著作権のラベルが非表示かどうかを返します。

SetShuffle()

クリップすべてをランダムに再生します (すでに再生されたクリップは除く)。クリップのシーケンスのみを含む複数の RAM ファイル (.ram または .rpm) または SMIL ファイルに作用します。有効な値は、TRUE および FALSE です。

GetShuffle()

シャッフル再生が使用可能かどうかを返します。

SetSource(String Source)

再生するクリップのURLを指定します。ソース URL は、rtsp://、http://、pnm://、または file:// で開始します。このメソッドは、RealPlayer 5.0 Netscape プラグインと互換性がありますが、5.0 ActiveX コントロールとはありません。

GetSource()

再生されているクリップの URL を返します。

SetCanSeek()

ユーザーがユーザー インターフェースからクリップ内を検索できるかどうか設定します。有効な値は、TRUE (デフォルト) および FALSE です。ライブまたはシミュレーション ライブクリップでは常に FALSE です。

GetCanSeek()

ライブまたはシミュレーション ライブ クリップでは FALSE が返されます。

クリップの位置

GetPosition()

クリップ内の現在の位置をミリ秒単位で返します。 有効な値は、>=0 および <=total clip lengthです。

SetPosition()

クリップ内の指定された位置をミリ秒単位で検索します。 有効な値は、<=0 および <total clip length です。

位置を >total length で設定すると、SetPosition() は、合計の長さと一致します。

GetLength()

クリップの合計の長さをミリ秒単位で返します。 有効な値は >=0 です。

クリップ/TAC 情報

GetTitle()

現在のクリップのタイトル文字列を返します。

SetTitle()

現在のタイトル文字列を設定し、既存のタイトル情報をすべて上書きします。その後で、GetTitle()はこの新しい値を返します。

GetAuthor()

現在のクリップの著者文字列を返します。

SetAuthor()

現在のクリップの著者列を設定し、既存の著者情報をすべてオーバーライドします。その後で、GetAuthor()は、この新しい値を返します。

GetCopyright()

現在のクリップの著作権文字列を返します。

SetCopyright()

現在のクリップの著作権文字列を設定し、既存の著作権情報をすべて上書きします。その後で、GetCopyright()は、この新しい値を返します。

GetClipWidth()

クリップ ウィンドウの幅をピクセル単位で返します。

GetClipHeight()

クリップ ウィンドウの高さをピクセル単位で返します。

再生リスト/マルチクリップ

HasNextEntry()

次のクリップ関数が使用可能かどうかテストします。次のクリップ関数は、接続されたソースが複数のクリップを含む RAM (.ram または .rpm) か SMIL ファイルであり、現在のクリップが RAM または SMIL ファイル内の最後のクリップではない場合に使用可能です。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。TRUE または FALSE を返します。

HasNextItem()

次のクリップ関数が使用可能かどうかテストします。次のクリップ関数は、接続されたソースが複数のクリップを含む RAM (.ram または .rpm) か SMIL ファイルであり、現在のクリップが RAM または SMIL ファイル内の最後のクリップではない場合に使用可能です。RealPlayer G2 および 5.0 で使用してください。RealPlayer G2 のみをサポートしている場合は、HasNextEntry() を代わりに使用してください。

DoNextEntry()

複数のクリップを含む RAM (.ram または .rpm) または SMIL ファイル内の次のクリップにスキップします。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。

DoNextItem()

複数のクリップを含むRAM (.ram または .rpm) または SMIL ファイル内の次のクリップへスキップします。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートしている場合には、DoNextEntry() を代わりに使用してください。

HasPrevEntry()

前のクリップ関数が使用可能かどうかテストします。前のクリップ関数は、接続されたソースが複数のクリップを含む RAM (.ram または .rpm) か SMIL ファイルであり、現在のクリップが RAM または SMIL ファイル内の最初のクリップではない場合に使用可能です。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。TRUE または FALSE を返します。

HasPrevItem()

前のクリップ関数が使用可能かどうかテストします。前のクリップ関数は、接続されたソースが複数のクリップを含む RAM (.ram または .rpm) か SMIL ファイルであり、現在のクリップが RAM または SMIL ファイル内の最初のクリップではない場合に使用可能です。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。TRUE または FALSEを返します。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2のみをサポートしている場合には、HasPrevEntry() を代わりに使用してください。

DoPrevEntry()

複数のクリップを含む、RAM (.ram または .rpm) または SMIL ファイル内の前のクリップへスキップします。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。

DoPrevItem()

複数のクリップを含む RAM (.ram または .rpm) または SMIL ファイル内の前のクリップへスキップします。 SMIL ファイルでは、<;par> グループは単一のクリップとして扱われます。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートしている場合には、DoPrevEntry() を代わりに使用してください。

GetCurrentEntry()

現在再生されているエントリ数を返します。

GetNumEntries()

再生リスト内のエントリ数を返します。

GetEntryTitle()

指定された再生リストのエントリに対するタイトルを返します。

GetEntryAuthor()

指定された再生リスト エントリに対する著作者を返します。

GetEntryCopyright()

指定された再生リスト エントリに対する著作権を返します。

GetEntryAbstract()

指定された再生リスト エントリに対する要約を返します。

ライブ再生

GetLiveState()

現在のクリップがライブかどうかを返します。有効な値は、TRUE または FALSE です。

ユーザー インターフェース コンポーネント

SetShowStatistics()

ダイアログ ボックスが表示されるように設定します。有効な値は、TRUE または FALSE です。

GetShowStatistics()

[RealPlayer 統計] ダイアログ ボックスが表示されるかどうかを返します。

HideShowStatistics()

[RealPlayer 統計] ダイアログ ボックスが表示されるように設定します。有効な値は、TRUE (非表示) または FALSE です。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートしている場合には、SetShowStatistics() を代わりに使用してください。

IsStatisticsVisible()

[RealPlayer 統計] ダイアログ ボックスが表示されるかどうかを返します。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートしている場合には、GetShowStatistics() を代わりに使用してください。

SetShowPreferences()

[RealPlayer 環境設定] ダイアログ ボックスを表示します。

GetShowPreferences()

[RealPlayer 環境設定] ダイアログ ボックスが表示されるかどうかを返します。.

EditPreferences()

[RealPlayer 環境設定] ダイアログ ボックスを表示します。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートする場合には、SetShowPreferences() を代わりに使用してください。

SetShowAbout()

[RealPlayer について] ダイアログ ボックスを表示します。RealPlayer G2 にのみ使用してください。

AboutBox()

[RealPlayer について] ダイアログ ボックスを表示します。RealPlayer G2 および 5.0 に使用してください。RealPlayer G2 のみをサポートしている場合には、SetShowAbout() を代わりに使用してください。

GetShowAbout()

[RealPlayer について] ボックスがオープンかどうかを返します。

エラー処理

SetWantErrors()

エラー シンクを設定します。有効な値は TRUE (トラップされたエラー、プレーヤーにエラー ダイアログがない) および FALSE (プレーヤーにエラー ダイアログがある) です。

GetWantErrors()

エラー ダイアログが表示されるかどうかを返します。

GetLastErrorMoreInfoURL()

直前のエラーから 「詳細情報」 の URL を返します。何も返さない場合もあります。

GetLastErrorRMACode()

直前のエラーから RMA エラー コードを返します。RMA エラーコードは、RealSystem G2 SDK 内のヘッダ ファイル pnresult.h に記述されています。SDK は http://www.real.com/devzone/ で入手可能です。通常の操作では、RealSystem コンポーネントはすべて、以下の基本コードを処理できなければなりません。これらは、RealSystem システムによって返されることがあります。

GetLastErrorSeverity()

システム障害を引き起こす可能性があるエラー。

エラー レベル
レベル 状態 使用方法
0 パニック システム障害を引き起こす可能性があるエラー。RealSystem によって、問題の訂正に必要な処置が取られます。これにより、プレゼンテーションがシャットダウンされることがあります。
1 重大 問題を回避するため、ユーザーの手動操作がすぐに必要とされるエラー。必要に応じて、RealSystem はプレゼンテーションをシャットダウンします。
2 致命的 ユーザーによる訂正操作が必要なエラー。必要に応じて、RealSystem はプレゼンテーションをシャットダウンします。
3 通常 通常のシステム操作では、重要な問題を引き起こさないエラー。
4 警告 システムの問題を引き起こさないが、注意を必要とする状況の警告。
5 注意 システムの問題を引き起こさないが、注意が必要な状況の通知。
6 通知 通知目的のメッセージ
7 デバッグ プログラムのデバッグに使用する情報。

GetLastErrorUserCode()

直前のエラーからエラーコードを返します。

GetLastErrorUserString()

最後のエラー ダイアログからエラー文字列を返します。何も返さない場合もあります。

GetLastStatus()

最後のステータス メッセージの文字を返します。

表示状態

SetOriginalSize()

イメージ ウィンドウを元のサイズに設定します。

GetOriginalSize()

現在のイメージが元のサイズかどうかを返します。TRUE は元のサイズを示しています。

SetDoubleSize()

イメージ ウィンドウを倍のサイズに設定します。

GetDoubleSize()

現在のイメージが倍サイズ モードであるかどうかを返します。TRUE は倍サイズを示しています。

SetFullScreen()

イメージをフルスクリーン モードに設定します。

GetFullScreen()

イメージが現在フルスクリーン モードであるかどうかを返します。TRUE はフルスクリーン モードを示しています。

ボリューム/ミュート コントロール

SetVolume()

ボリューム レベルを設定します。有効な値は 0-100 です。

GetVolume()

現在のボリューム レベルを返します。

SetMute()

ミュート状態を設定します。有効な値は、TRUE および FALSE です。

GetMute()

ボリュームがミュートされたかどうかを返します。

GetStereoState()

現在のクリップがステレオかどうかを返します。ステレオの場合には TRUE、モノラルの場合には FALSE がそれぞれ返されます。

コンテンツ メニュー

SetEnableContextMenu()

マウスの右ボタンがクリックされたときにコントロールがデフォルト コンテキスト メニューを表示するかどうかを指定します。有効な値は、TRUE (使用可能、デフォルト) および FALSE (使用不可) です。

GetEnableContextMenu()

コンテンツ メニューが現在使用可能かどうかを返します。TRUE (使用可能、デフォルト) または FALSE (使用不可) が返されます。

SetEnableOriginalSize()

コンテキスト メニューで元のサイズ オプションを使用可能にします。有効な値は、TRUE (デフォルト) および FALSE です。

GetEnableOriginalSize()

コンテキスト メニューで元のサイズ オプションが使用可能かどうかを返します。

SetEnableDoubleSize()

コンテキスト メニューで倍サイズ オプションが使用可能かどうかを返します。有効な値は TRUE および FALSE (デフォルト) です。

GetEnableDoubleSize()

コンテキスト メニューで倍サイズ オプションが使用可能かどうかを返します。

SetEnableFullScreen()

コンテキスト メニューでフルスクリーン オプションを使用可能にします。有効な値は TRUE (デフォルト) および FALSE です。

GetEnableFullScreen()

コンテキスト メニューでフルスクリーン オプションが使用可能かどうかを返します。

SetImageStatus()

ステータス テキストがイメージ ウィンドウに書き込まれるかどうか設定します。

GetImageStatus()

ステータス テキストがイメージ ウィンドウに書き込まれるかどうかを返します。

ネットワーク情報

GetSourceTransport()

再生に使用されるソース プロトコルの文字列を返します。1 から n までの整数を値として取ります。n は、GetNumSources() によって返されたソース数です。

GetNumSources()

プレゼンテーションのソース数を返します。

GetPacketsTotal()

プレゼンテーションの合計パケット数を返します。

GetPacketsReceived()

サーバーから受信した合計パケット数を返します。

GetPacketsOutofOrder()

サーバーから順不同で受信したパケットの合計を返します。

GetPacketsMissing()

サーバーから受信したパケットで、再生に間に合わなかったパケットの合計を返します。

GetPacketsEarly()

再生前にサーバーから受信したパケットの合計を返します。

GetPacketsLate()

再生開始後にサーバーから受信したパケットの合計を返します。

GetBandwidthAverage()

使用可能な帯域幅の平均を返します。

GetBandwidthCurrent()

現在使用可能な帯域幅を返します。

バージョン情報

GetVersionInfo()

組み込まれた RealPlayer (親 RealPlayer 以外) のメジャーおよびマイナー バージョン情報を 6.0.0.128 のように返します。

GetIsPlus()

クライアントが RealPlayer Plus かどうかを返します。

イベント フラッグ

SetWantKeyboardEvents()

キーボード イベントが送信されるかどうか設定します。有効な値は TRUE および FALSE (デフォルト) です。

GetWantKeyboardEvents()

キーボード イベントが送信されるかどうかを返します。

SetWantMouseEvents()

マウス イベントが送信されるかどうか設定します。有効な値は TRUE および FALSE (デフォルト) です。

GetWantMouseEvents()

マウス イベントが送信されるかどうかを返します。

ユーザー環境の設定

GetConnectionBandwidth()

RealPlayer 環境設定でユーザーによって設定された標準/最大帯域幅を返します。

GetPreferedLanguageString()

RealPlayer 環境設定でユーザーによって設定されたコンテンツの設定言語を返します。

GetPreferedLanguageID()

設定言語 ID を返します。言語コードのリストについては、『RealSystem G2 Production Guide』 にある SMIL 言語コードの付録を参照してください。

GetUserCountryID()

オンライン登録中にユーザーが選択した国を返します。

RealPlayer 5.0 との互換性

次のメソッドは RealPlayer G2 および RealPlayer 5.0 で使用されます。RealPlayer の両方のバージョンをサポートするために、アプリケーションではこのコマンド セットだけを実行することができます。

Copyright © 1998 RealNetworks
RealNetworks のテクニカル サポートは、ここをクリックしてください。
この文書に関するご意見については、 ここをクリック.
してください。このファイルの最終更新時刻は 12/18/98 17:51:30 です。
前 次