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