4D Doc Center : PLAY

4D v12.4

PLAY


PLAY ( objectName {; channel} )

引数	型	説明
objectName	文字	発生する音の名前 Windows: .WAV、 .MID または .AVI ファイル任意のプラットフォーム: Mac OS ベースの "snd" リソースまたは非同期指定を中断する場合、空の文字列
channel	倍長整数	指定した場合、シンセサイザチャネルと非同期指定省略した場合、同期指定

説明

PLAY コマンドはサウンドやマルチメディアファイルを再生します。再生したいファイルの完全なパス名を objectName に渡します。Mac OSでは、コマンドを使用してサウンドリソースやシステムサウンドを再生することもできます。

ファイルを再生するには、objectNameにそのパス名を渡します。フルパス名またはデータベースストラクチャファイルからの相対パス名を渡せます。
主なサウンドおよびマルチメディアフォーマットがサポートされています: .WAV, .MP3, .AVI, .AIFF (Mac OS), 等。Mac OSでは、コマンドは特にCore Audioフォーマットをサポートしています。
Note: 非同期モードでマルチメディアファイルやオブジェクトを再生することはできません。そうしたい場合はOLEサービスを使用します。
(Mac OSのみ) 'snd ' リソースやシステムサウンドを再生するには、objectName 引数に直接その名前を渡します。
Note: 互換性のため、4Dはまず'snd 'リソースからobjectNameを探します。

引数 channel は、Macintoshシンセサイザチャネルを指定します。channel が指定されていない場合、 channel はデジタル化された単純なサウンドとみなされ、同期指定になります。同期指定では、サウンドが終了するまですべての処理が停止します。channel が0の場合、チャネルはデジタル化された単純なサウンドとみなされ、非同期指定になります。非同期指定では、処理は停止せず、サウンドがバックグラウンドで再生します。

同期サウンドの再生を停止するには、以下のステートメントを使用します。

PLAY("";0)

例題 1

Windows上でのビデオファイルの再生方法を以下の例題で示します。

 $DocRef :=Open document("";"AVI")

 If(OK=1)

    CLOSE DOCUMENT($DocRef)

    PLAY(Document)

 End if

例題 2

以下のコードがstartupメソッドにあります。Macintosh上では、ウエルカムの音でユーザを歓迎します。

PLAY("Welcome Sound") `ウエルカムの音を再生する