ImportAudio

詳細

現在のシーンに、オーディオ ファイルを読み込みします。 指定のモデルのオーディオ ソース リストに、新しいオーディオ ソースを追加します。 現在のモデルに Mixer オブジェクトが含まれていない場合は、このオブジェクトが追加されます（これによって、オーディオソースを追加できます）。

注: サポートされているオーディオファイル形式は、Microsoft Audio Video Interleave（.avi）、Apple Audio Interchange（.aif、.aiff、.aifc)、Quicktime（.mov、.qt）、およびWAVファイル（.wav）です。

このコマンドは、インターネットからのダウンロード ファイルに対応しています。ファイル名に URL を指定すると、コマンドが実行される前にそのファイルがローカルにダウンロードされます。

警告: このコマンドを実行するには、ディスク上にオーディオソースファイルが存在していなければなりません。

スクリプト構文

oReturn = ImportAudio( Model, [FileName], [Name] );

戻り値

新しいオーディオSourceを戻します。

パラメータ

パラメータ タイプ 説明
Model 文字列 オーディオの読み込み先モデル
FileName 文字列 読み込みするファイルの完全パス

指定したファイルがオーディオ ファイルでない場合には、エラーが戻されます。

デフォルト値：ファイルブラウザが開きます。

Name 文字列 新しいオーディオ ソースに使用する名前

デフォルト値： ファイル名

例

VBScript の例

'---------------------------------------------------------

' This example shows how to import audio files into a 

' model. Note: You must choose an audio source from a 

' dialog box in this example

'---------------------------------------------------------

' First create a model to hold the sound clip.

dim oModel

SICreateModel , "AudioModel", , oModel

logmessage oModel + " model created."

' Now import an audio source file.

dim oAudioSource, Fullname, Filename, SamplingRate, ChannelCnt, Duration

set oAudioSource = ImportAudio( oModel, , "Sound" )

' Now display information about the clip created.

Fullname = GetValue( oAudioSource.FullName )

Filename = GetValue( oAudioSource.FileName )

SamplingRate = GetValue( oAudioSource.SamplingRate )

ChannelCnt = GetValue( oAudioSource.ChannelCount )

Duration = GetValue( oAudioSource.Duration )

logmessage "Audio source created: " & Fullname

logmessage "Audio filename      : " & Filename

logmessage "Audio Sampling Rate : " & CInt(SamplingRate)

logmessage "Audio Channel Count : " & CInt(ChannelCnt)

logmessage "Audio Duration      : " & Duration

'---------------------------------------------------------

' Output from this script:

'INFO : "Audio source created: Sources.Sound"

'INFO : "Audio filename      : <filename>"

'INFO : "Audio Sampling Rate : <sampling rate>"

'INFO : "Audio Channel Count : <channel count>"

'INFO : "Audio Duration      : <duration (sec.)>"

'---------------------------------------------------------

関連項目

AddAudioClip