previous next

第 2 章:ActiveX コントロール リファレンス

この章では、RealProducer ActiveX コントロールで使用されるプロパティ、メソッドおよびイベントについて説明します。

プロパティ

入力プロパティ
名前 タイプ 説明
InputType INPUT_SOURCE_FILE|
INPUT_SOURCE_CAPTURE		 エンコードするファイルのタイプ: ファイルまたはキャプチャリング デバイス
InputFilename String 入力ファイルのパス名
InputCaptureAudioDriver Long 使用するドライバーのインデックス
InputCaptureVideoDriver Long 必要なドライバーのインデックス
InputDoAudio Boolean オーディオをエンコードするかどうか
InputDoVideo Boolean ビデオをエンコードするかどうか
InputDoEvents Boolean イベントをエンコードするかどうか
InputNumAudioDrivers Long 使用可能なオーディオ ドライバーの数 (get のみ)
InputNumVideoDrivers Long 使用可能なビデオ ドライバーの数 (get のみ)

出力パラメータ
名前 タイプ 説明
DoOutputFile Boolean 出力ファイルを作成します。
OutputFilename String 出力ファイルのファイル名とパス名
TempDirectory String エンコーディング時に使用される一時ディレクトリのパス
DoOutputServer Boolean サーバーにストリームを作成します (入力タイプは INPUT_SOURCE_CAPTURE でなければなりません)。
ServerName String サーバー名
ServerPort Long サーバー上のエンコーダのマウント ポイントのポート
ServerStream String サーバー上のストリーム名
ServerUsername String エンコーダのマウント ポイントにアクセスすることきに使用されるユーザー名
ServerPassword String エンコーダのマウント ポイントにアクセスすることきに使用されるパスワード
ServerTransport SERVER_TRANSPORT_UDP|
SERVER_TRANSPORT_TCP		 サーバーの接続に使用されるプロトコル：UDP または TCP
ListBroadcast Boolean

クリップを Janus に登録するかどうか
(現在Janusプロジェクトは使用できません)

クリップ プロパティ
名前 タイプ 説明
タイトル String クリップのタイトル
著作者 String クリップの著作者
著作権 String 著作権の日付とクリップの所有者
説明 String クリップのコンテンツについての簡単な説明
キーワード String クリップを要約する語
評価 RATING_G|RATING_PG|
RATING_R|RATING_X		 クリップのコンテンツの評価
SelectiveRecord Boolean クリップが録音可能かどうか
MobilePlay Boolean モバイル プレイヤーがクリップをダウンロードできるかどうか
索引作成 Boolean 検索エンジンによりクリップに索引を付けられるかどうか

ターゲット設定
名前 タイプ 説明
Target28KModem Boolean 28K モデム用のストリームを作成します。
Target56KModem Boolean 56K モデム用のストリームを作成します。
TargetSingleISDN Boolean ISDN 単一回線用のストリームを作成します。
TargetDualISDN Boolean ISDN 2 回線用のストリームを作成します。
TargetDSLCableModem Boolean DSL または ケーブル モデム用のストリームを作成します。
TargetLAN Boolean LAN またはイントラネット用のストリームを作成します。
Target256KDSLCableModem Boolean 256K DSL または ケーブル モデム用のストリームを作成します。
Target384KDSLCableModem Boolean 384K DSL またはケーブル モデム用のストリームを作成します。
Target512KDSLCableModem Boolean 512K DSL またはケーブル モデム用のストリームを作成します。
AudioContent AUDIO_CONTENT_VOICE|
AUDIO_CONTENT_VOICE_BACKGROUND|
AUDIO_CONTENT_MUSIC|
AUDIO_CONTENT_MUSIC_STEREO		 エンコードされるオーディオ タイプを判別します。
VideoQuality VIDEO_QUALITY_NORMAL|
VIDEO_QUALITY_SMOOTH_MOTION|
VIDEO_QUALITY_SHARP_IMAGE|
VIDEO_QUALITY_SLIDESHOW		 記録するビデオの品質を判別します。
SureStream Boolean SureStream に記録されるかどうか
PlayerCompatibility PLAYER_6|
PLAYER_5		 クリップと互換性のある RealPlayer のバージョンを指定します。
EmphasizeAudio Boolean ストリームの切り替え時にビデオではなくオーディオを強調するかどうか
DoAudioOnlyMultimedia Boolean オーディオ専用ファイルが、マルチメディア ターゲットの設定を使用するかどうか。Trueの場合は、オーディオクリップがオーディオ ターゲットの設定を占有します。この場合、ビット レートは最大になります。

ビデオの設定
名前 タイプ 説明
VideoResizingEnabled Boolean 入力ビデオのサイズが変更できるかどうか
VideoOutputWidth Long 新しくサイズ変更されたビデオ イメージの幅 (ピクセル単位)
VideoOutputHeight Long 新しくサイズ変更されたビデオ イメージの高さ (ピクセル単位)
VideoCroppingEnabled Boolean 出力ビデオ イメージをクロッピングできるかどうか
VideoCropLeft Long 出力ビデオの左端からクロッピングされるピクセル数
VideoCropTop Long 出力ビデオの上端からクロッピングされるピクセル数
VideoCropWidth Long クロッピングされるイメージの幅 (ピクセル単位)
VideoCropHeight Long クロッピングされるイメージの高さ (ピクセル単位)
VideoNoiseFiltering NOISE_FILTER_OFF|
NOISE_FILTER_LOW|
NOISE_FILTER_HIGH		 使用されるビデオ ノイズ フィルタリングの量:off、low、または high
VBREncoding Boolean 可変ビット レート エンコーディングを使用します。
VBRMaxStartupLatency Long 起動時の最大待ち時間 (ミリ秒単位)
TwoPassEncoding Boolean ビデオに 2 パス エンコーディングを使用します。
MaxTimeBetweenKeyframes Long ビデオのキーフレーム間の最大時間
LossProtection Boolean ビデオに消失保護を使用します。
HighQualityResize Boolean ビデオに高品質サイズへ変更を使用します。
InverseTelecineFilter Boolean ビデオにテレビ映像反転フィルタを使用します。
DeInterlaceFilter Boolean ビデオにインターレース解除フィルタを使用します。

Codec プロパティ
名前 タイプ 説明
AudioCodecEnum Object (EnumIDispatch) オーディオ codec を介するエミュレータ
VideoCodecEnum Object (EnumIDispatch) ビデオ codec を介するエミュレータ

非ブラウズ可能プロパティ
名前 タイプ 説明
IsSourceOpen Boolean ソースが開いているかどうか (get のみ)
IsEncoding Boolean エンコーディングしているかどうか (get のみ)
LastError Long 最後のエラー結果コード (get のみ)
OutputVideoWindowTarget Long 出力ビデオ ウィンドウに表示されるターゲット オーディエンス (IsEncoding が True の場合に、エンコーディングの開始後に設定されます)。

統計プロパティ
名前 タイプ 説明
NumTargetStreams Long クリップのターゲット ストリームの数 (get のみ)
NumVideoStreams Long クリップのビデオ ストリームの数 (get のみ)
NumAudioStreams Long クリップのオーディオ ストリームの数 (get のみ)

メソッド

コントロール

OpenSource()

ビデオとオーディオ ソースを開きます。これにより、ビデオ ウィンドウのサイズが変更可能になり、ビデオの最初のフレームまたはカメラからのオーバーレイが表示されます。OpenSource を呼び出した後、 GetInputVideoSize でビデオのサイズを調べることができます。ライブ ビデオをキャプチャリングする場合、ビデオ カードを設定するダイアログにアクセスできます。
パラメータ: なし

StartEncoding()

エンコーディングを開始します。最初に、OpenSource を呼び出す必要はありません。
パラメータ: なし

StopEncoding()

エンコーディングを中止し、ソースを閉じます。IsSourceOpen または IsEncoding が True の場合しかこのメソッドを呼び出すことはできません。
パラメータ: なし

エンコーディング イベント

SendRealMediaEvent()

URL イベントまたはタイトル、著作者、著作権情報をストリームまたはファイルに送信します。タイムスタンプおよび継続時間が指定されていないと、データがエンコーディングされる時間にイベントが発生します。このイベントは 1 回しか発生しません。このメソッドは IsEncoding が True の場合しか呼び出されません。
パラメータ: EventType (EVENT_TYPE_URL|EVENT_TYPE_TITLE|EVENT_TYPE_AUTHOR|EVENT_TYPE_COPYRIGHT), EventText (String), Timestamp [optional] (Long), Duration [optional] (Long)

エラー処理

GetErrorString()

エラー コードのエラー文字列を戻します。
パラメータ: ErrorCode (Long)

設定

LoadProducerSettings()

前回 RealProducer が使用されたときの設定値をすべてロードします。このメソッドは、前に指定した設定を上書きします。
パラメータ: なし

入力プロパティ

GetAudioDriverName()

要求されたインデックス (0から始まる) のオーディオ ドライバー名を戻します。VB Script ではサポートされていません。
パラメータ: Index (Long), DriverName (String)

GetVideoDriverName()

要求されたインデックス (0から始まる) のビデオ ドライバー名を戻します。VB Script ではサポートされていません。
パラメータ: Index (Long), DriverName (String)

クリップ プロパティ

GetStringProperty()

要求された文字列プロパティの値を戻します (カスタム プロパティ)。VB Script ではサポートされていません。
パラメータ: PropertyName (String), Value (String)

SetStringProperty()

ファイルの文字列プロパティ/値のペアを設定します (カスタム プロパティ)。
パラメータ: PropertyName (String), Value (String)

GetNumberProperty()

要求された数プロパティの値を戻します (カスタム プロパティ)。VB Script ではサポートされていません。
パラメータ: PropertyName (String), Value (Long)

SetNumberProperty()

ファイルの数プロパティ/値のペアを設定します (カスタム プロパティ)。
パラメータ: PropertyName (String), Value (Long)

RemoveProperty()

プロパティ/値のペアを削除します (カスタム プロパティ)。
パラメータ: PropertyName (String)

ビデオ設定

GetInputVideoSize()

現在のビデオのサイズを取得します。IsSourceOpen または IsEncoding が True の場合しかこのメソッドを呼び出すことはできません。VB Script ではサポートされていません。
パラメータ: Width (Long), Height (Long)

ShowVideoCardFormatDialog()

ビデオ カード フォーマットのダイアログを表示します。IsSourceOpen が TRUE および IsEncoding が FALSE の場合、および InputType が INPUT_SOURCE_CAPTURE の場合にのみ、このメソッドを呼び出すことができます。
パラメータ: なし

ShowVideoCardSourceDialog()

ビデオ カード ソースのダイアログを表示します。IsSourceOpen が TRUE および IsEncoding が FALSE の場合、および InputType が INPUT_SOURCE_CAPTURE の場合にのみ、このメソッドを呼び出すことができます。
パラメータ: なし

ShowVideoCardCompressionDialog()

ビデオ カード圧縮のダイアログを表示します。IsSourceOpen が TRUE および IsEncoding が FALSE の場合、および InputType が INPUT_SOURCE_CAPTURE の場合にのみ、このメソッドを呼び出すことができます。
パラメータ: なし

ターゲット オーディエンス

TargetAudienceInfo()

ターゲット オーディエンスの TargetAudienceInfo オブジェクトを戻します。
パラメータ: TargetAudience (TARGET_28_MODEM|TARGET_56_MODEM|TARGET_SINGLE_ISDN|TARGET_DUAL_ISDN|TARGET_LAN_LOW|TARGET_LAN_HIGH)

RestoreTargetDefaults()

ターゲット オーディエンスの設定をすべて復元します。
パラメータ: なし

統計

GetTargetStream()

ターゲット ストリームの情報を取得します。オーディオまたはビデオ ストリーム インデックスの値が -1 の場合には、そのタイプにストリームがないことを意味します。VB Script ではサポートされていません。
パラメータ: Index (Long), TargetAudience (TARGET_28_MODEM|TARGET_56_MODEM|TARGET_SINGLE_ISDN|TARGET_DUAL_ISDN|TARGET_LAN_LOW|TARGET_LAN_HIGH), AudioStreamIndex (Long), VideoStreamIndex (Long), 50Compatible (Bool)

GetAudioStream()

オーディオ ストリームの情報を取得します。ビット レートは 1 秒あたりのビット数、周波数特性はヘルツ、待ち時間はミリ秒単位、パフォーマンスはエンコーディング時間と再生時間の比率で表されます。VB Script ではサポートされていません。
パラメータ: Index (Long), CodecName (String), Bitrate (Long), FrequencyResponse (Long), Latency (Long), Performance (Long), 50Compatible (Bool)

GetVideoStream()

ビデオ ストリームの情報を取得します。ビット レートは 1 秒あたりのビット数、フレーム レートは 1 秒あたりのフレーム数、待ち時間はミリ秒単位、パフォーマンスは再生時間とエンコーディング時間の比率で表されます。VB Script ではサポートされていません。
パラメータ: Index (Long), CodecName (String), Bitrate (Long), FrameRate (Float/Single), Latency (Long), Quality (Long) Performance (Long), 50Compatible (Bool)

UpdateStatistics()

現在の設定で統計データを更新します。
パラメータ: なし

イベント

OnEncodingStarted()

エンコーディングの開始後に呼ばれます。
パラメータ:なし

OnEncodingStopped()

エンコーディングの終了後に呼ばれます。
パラメータ:なし

OnErrorOccurred()

エンコーディング エラーが発生した場合に呼ばれます。
パラメータ: ErrorCode (Long), ErrorString (String)

OnAudioLevelClipped()

オーディオ レベルをクリッピングした場合に呼ばれます。
パラメータ: Timestamp (Long), AudioLevel (Long)

OnEncodingProgressChanged()

エンコーディングの進捗状況に変更があると呼ばれます。
パラメータ: Duration (Long), PercentDone (Long), Timestamp (Long), AudioLevel (Long)

OnVideoWindowSized()

必要な最小サイズよりコントロール ウィンドウが小さい場合、最小サイズに変更してからこのイベントが呼ばれます。
パラメータ: Width (Long), Height (Long)

RealProducer コントロールで使用するオブジェクト

オーディオ Codec 情報

オーディオ Codec 情報プロパティ
名前 タイプ 説明
Bitrate Long codecのビット レート
CodecCookie CodecCookie codec の識別子
CodecDescription String codec の説明
CodecForVersion CodecCookie 指定された RealPlayer バージョン で使用する codec を戻します。
CodecName String codec の名前
FrequencyResponse Long codec の周波数特性 (ヘルツ単位)
NumChannels Long オーディオ チャンネルの数
OldestCompatiblePlayer Long codec で使用できるRealPlayer の最も古い互換バージョン
SampleRate Long codec のサンプル レート (ヘルツ単位)
SampleSize Long codec のサンプル サイズ (ビット単位)

ビデオ Codec 情報

ビデオ Codec 情報プロパティ
名前 タイプ 説明
CodecCookie CodecCookie Codec 識別子
CodecDescription String codec の説明
CodecForVersion CodecCookie 指定された RealPlayer バージョンで使用される codec を戻します。
CodecName String codec の名前
OldestCompatiblePlayer Long codec で使用できるRealPlayer の最も古い互換バージョン

Codec Cookie

Codec Cookie プロパティ
名前 タイプ 説明
codecID Long codec タイプを指定します。
flavorID Long codec フレーバを指定します。

ターゲット オーディエンス情報

ターゲット オーディエンス情報プロパティ
名前 タイプ 説明
AudioCodec CodecCookie ターゲット オーディエンスのオーディオ codec。オーディオ コンテンツとターゲット オーディエンスのタイプによって異なります。TargetAudienceType (TARGET_AUDIENCES_AUDIO | TARGET_AUDIENCES_VIDEO | TARGET_AUDIENCES_MULTIMEDIA) と AudioContent (AUDIO_CONTENT_VOICE | AUDIO_CONTENT_VOICE_BACKGROUND | AUDIO_CONTENT_MUSIC | AUDIO_CONTENT_MUSIC_STEREO) をパラメータとして取ります。
MaxFrameRate Single 最大フレーム レート (1 秒あたりのフレーム数)
TargetAudienceID Long ターゲット オーディエンスのインデックス
TargetAudienceName String ターゲット オーディエンスの名前
TargetBitrate Single ターゲット オーディエンスのビット レート (1 秒あたりのビット数)
VideoCodec CodecCookie ターゲット オーディエンスのビデオ codec

EnumIDispatch

First()

リストの最初のエレメントを戻し、リストを初期状態にリセットします。
パラメータ: なし

Next()

リストの次のエレメントを戻します。
パラメータ: なし

GetCount()

リストのエレメント数を戻します。
パラメータ: なし

Copyright © 1998-1999 RealNetworks
RealNetworks テクニカル サポートは、ここをクリックしてください。
この文書に関するご意見については、ここをクリックしてください。
このファイルの最終更新時刻は 03/01/00 17:55:22 です。
previous next