第 4 章: CallBack メソッド

この章では、RealPlayer がアプリケーションの状況を知らせるために呼び出すメソッドについて説明します。

RealPlayer G2 コールバック

onClipOpened(shortClipName,URL)

コントロールがクリップを開くと送信されます。パラメータ:


string shortClipName


string URL

onClipClosed()

コントロールが現在開いているクリップがないとを送信されます。パラメータはありません。

onShowStatus(statusText)

ステータステキストが変更中であると送信されます。パラメータ:


string statusText

onGoToURL(URL,target)

URL イベントが現在再生中の RealPlayer クリップを検出すると、送信されます。このイベントは、AutoGotoURL プロパティが FALSE の場合にのみ起こります。パラメータ:


string URL


string target

OnPositionChange(current position, total length)

クリップ内の位置が変更されると呼び出されます。クリップの現在の位置がミリ秒単位で返されます。パラメータ:


long position


long length

OnLengthChange(length)

クリップの長さが変更された場合 (通常は新規クリップがロードされた場合) に呼び出されます。パラメータ:


long length (in milliseconds)

OnVolumeChange(volume)

音量が変更されると呼び出されます。現在の音量の値が返信されます。有効な音量域は 0-100 で、0 は無音であることを示します。パラメータ:


short volume

OnTitleChange(title)

タイトル文字列が変更されると呼び出されます。新しいタイトル文字列が戻されます。パラメータ:


string title

OnAuthorChange(author)

著作者文字列が変更されると呼び出されます。新しい著作者文字列が戻されます。パラメータ:


string author

OnCopyrightChange(copyright)

著作権文字列が変更されると呼び出されます。新しい著作権文字列が返信されます。パラメータ:


string copyright

OnPlayStateChange(newPlayState)

再生状態が変更されると呼び出されます。再生状態の値については、GetPlayState()を参照してください。パラメータ:


long newPlayState

OnErrorMessage(Severity, RMAErrorCode, UserErrorCode, messageText, MoreInfoURL)

エラーが発生すると呼び出されます。エラーコードと重要度の詳細については、GetLastErrorRMACode() と GetLastErrorSeverity() を参照してください。

OnBuffering(int Flags, short PercentComplete)

バッファリングの完了度がパーセンテージで戻されます。

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

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

OnContacting(String Hostname)

RealPlayer がホストに接続すると呼び出されます。ホスト名文字列が戻されます。

OnKeyDown(int KeyCode)

ユーザーがキーボードのキーを押したままにすると戻されます。SetWantKeyboardEvents() が TRUE に設定された場合にのみ送信されます。

OnKeyPress(int KeyCode)

ユーザーがキーボードのキーを押してから解放するとキーコードが戻されます。SetWantKeyboardEvents() が TRUE に設定された場合にのみ送信されます。

OnKeyUp(int Keycode)

ユーザーがキーボードのキーを解放するとキーコードが戻されます。SetWantKeyboardEvents() が TRUE に設定された場合にのみ送信されます。

OnLButtonDown(int nButtonFlags, int xPos, int yPos)

ユーザーがマウスの左ボタンを押すと、マウスの位置とフラグが戻されます。SetWantMouseEvents() が TRUE に設定された場合にのみ送信されます。

OnLButtonUp(int nButtonFlags, int xPos, int yPos)

ユーザーがマウスの左ボタンを解放すると、マウスの位置とフラグが戻されます。SetWantMouseEvents() が TRUE に設定された場合にのみ送信されます。

OnRButtonDblClk(int nButtonFlags, int xPos, int yPos)

ユーザーがマウスの右ボタンをダブルクリックすると、マウスの位置とフラグが戻されます。SetWantMouseEvents() が TRUE に設定された場合にのみ送信されます。

OnRButtonUp(int nButtonFlags, int xPos, int yPos)

ユーザーがマウスの右ボタンを解放すると、マウスの位置とフラグが戻されます。SetWantMouseEvents() が TRUE に設定された場合にのみ送信されます。

OnMouseMove(int nButtonFlags, int xPos, int yPos)

ユーザーがマウスを移動すると、マウスの位置とフラグが戻されます。SetWantMouseEvents() が TRUE に設定された場合にのみ送信されます。

OnMute(boolean bIsMute)

音量がミュートされると呼び出されます。

OnPreFetchComplete()

コンポーネントがストリームヘッダー情報を取り出すと呼び出されます。PREFETCH が <EMBED> や <OBJECT> タグで true に設定された場合、または GetPreFetch()が TRUE に設定された場合に呼び出されます。

OnPreSeek(int OldTime, int NewTime)

ユーザーが、プレゼンテーションの位置調節つまみを移動させて検索を実行すると呼び出されます。検索開始時のプレゼンテーション時間と検索時間が戻されます。

OnPostSeek(int OldTime, int NewTime)

検索が完了すると呼び出されます。検索開始前のプレゼンテーション時間と、検索開始後の時間値が戻されます。

OnPresentationClosed()

プレゼンテーションが停止すると呼び出されます。

OnPresentationOpened()

プレゼンテーションが開始すると呼び出されます。

RealPlayer 5.0 との互換性

次のコールバックメソッドは、RealPlayer G2 と RealPlayer 5.0 で使用されます。RealPlayer の両バーションをサポートしている場合は、アプリケーションは以下のメソッドのみを受信します。