Struct CriAtomExPlayback

再生ID

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Namespace: CriWare

Assembly: CriWare.CriAtom.dll

Syntax

public readonly struct CriAtomExPlayback

Remarks

説明: Start() 関数実行時に返されるIDです。プレーヤー単位ではなく、 Start() 関数で再生した個々の音声に対してパラメーター変更や状態取得を行いたい場合、本IDを使用して制御を行う必要があります。無効な再生IDはInvalidPlaybackIdです。

Properties

Invalid

無効なプレイバック

Declaration

public static CriAtomExPlayback Invalid { get; }

Property Value

Type	Description
CriAtomExPlayback

NativeHandle

ネイティブハンドル

Declaration

public uint NativeHandle { get; }

Property Value

Type	Description
uint

Methods

GetAisacControlById(uint, out float)

LE Pro

AISACコントロール値の取得（コントロールID指定）

Declaration

public bool GetAisacControlById(uint controlId, out float controlValue)

Parameters

Type	Name	Description
uint	controlId	コントロールID
float	controlValue	コントロール値（0.0f～1.0f）、未設定時は-1.0f

Returns

Type	Description
bool	AISACコントロール値が取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声に設定されているAISACコントロール値を、コントロールID指定で取得します。 AISACコントロール値が取得できた場合（未設定時も「-1.0fが取得できた」と扱われます）、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

注意: 本関数は、音声再生中のみAISACコントロール値を取得可能です。再生終了後や、発音数制御によりボイスが消去された場合には、 AISACコントロール値の取得に失敗します。

Declaration

public bool GetAisacControlByName(ArgString controlName, out float controlValue)

Parameters

Type	Name	Description
ArgString	controlName	コントロール名
float	controlValue	コントロール値（0.0f～1.0f）、未設定時は-1.0f

Returns

Type	Description
bool	AISACコントロール値が取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声に設定されているAISACコントロール値を、コントロール名指定で取得します。 AISACコントロール値が取得できた場合（未設定時も「-1.0fが取得できた」と扱われます）、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

GetAtomPlayer()

LE Pro

Atomプレーヤーの取得

Declaration

public CriAtomPlayer GetAtomPlayer()

Returns

Type	Description
CriAtomPlayer

Remarks

説明: 再生IDに紐づけられたボイス（＝Atomプレーヤーオブジェクト）を取得します。

備考: 複数の波形データを含むキューを再生している場合、本関数は最初に見つかったボイスに対応するAtomプレーヤーオブジェクトを返します。波形データが再生されていない場合、本関数はnullを返します。

GetBeatSyncInfo(out Info)

LE Pro

ビート同期情報の取得

Declaration

public bool GetBeatSyncInfo(out CriAtomExBeatSync.Info info)

Parameters

Type	Name	Description
CriAtomExBeatSync.Info	info	ビート同期情報

Returns

Type	Description
bool	CriBool 成功／失敗

Remarks

説明: 再生中のキューのビート同期情報を取得します。現在のBPM、小節のカウント、拍のカウント、拍の進捗割合(0.0～1.0)を取得することができます。キューにはビート同期情報が設定されている必要があります。キューリンクやスタートアクションで再生しているキューの情報は取得できません。

備考: 以下に該当するデータを再生中の場合、ビート同期情報の取得に失敗します。

キュー以外のデータを再生している。（ビート同期情報が存在しないため）
ビート同期情報が設定されていないキューを再生している。
ビート同期情報が設定されているキューを"間接的"に再生している。（キューリンクやスタートアクションで再生している）

GetCurrentBlockIndex()

LE Pro

再生音のカレントブロックインデックスの取得

Declaration

public int GetCurrentBlockIndex()

Returns

Type	Description
int	int カレントブロックインデックス

Remarks

説明: Start() 関数で再生されたブロックシーケンスのカレントブロックインデックスを取得します。

備考: 再生IDにより再生しているデータがブロックシーケンスではない場合は、 InvalidBlockIndex が返ります。

GetFormatInfo(out FormatInfo)

LE Pro

再生音声のフォーマット情報の取得

Declaration

public bool GetFormatInfo(out CriAtomEx.FormatInfo info)

Parameters

Type	Name	Description
CriAtomEx.FormatInfo	info	フォーマット情報

Returns

Type	Description
bool	CriBool 情報が取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声のフォーマット情報を取得します。フォーマット情報が取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

備考: 複数の音声データを含むキューを再生した場合、最初に見つかった音声データの情報が返されます。

注意: 本関数は、音声再生中のみフォーマット情報を取得可能です。再生準備中や再生終了後、発音数制御によりボイスが消去された場合には、フォーマット情報の取得に失敗します。ボイスの再生状態は GetStatus() 関数で取得することはできないためご注意ください。

GetNumPlayedSamples(out long, out int)

LE Pro

再生サンプル数の取得

Declaration

public bool GetNumPlayedSamples(out long numSamples, out int samplingRate)

Parameters

Type	Name	Description
long	numSamples	再生済みサンプル数
int	samplingRate	サンプリングレート

Returns

Type	Description
bool	CriBool サンプル数が取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声の再生サンプル数、およびサンプリングレートを返します。再生サンプル数が取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。（エラー発生時は num_samples や sampling_rate の値も負値になります。）

備考: 再生済みサンプル数の値の精度は、プラットフォーム SDK のサウンドライブラリに依存します。（プラットフォームによって、再生済みサンプル数の正確さは異なります。）複数の音声データを含むキューを再生した場合、最初に見つかった音声データの情報が返されます。

注意: ドライブでリードリトライ処理等が発生し、音声データの供給が途切れた場合、再生サンプル数のカウントアップが停止します。（データ供給が再開されれば、カウントアップが再開されます。）本関数は、音声再生中のみ再生サンプル数を取得可能です。再生終了後や、発音数制御によりボイスが消去された場合には、再生サンプル数の取得に失敗します。

GetNumRenderedSamples(out long, out int)

LE Pro

サウンドバッファーへの書き込みサンプル数の取得

Declaration

public bool GetNumRenderedSamples(out long numSamples, out int samplingRate)

Parameters

Type	Name	Description
long	numSamples	書き込み済みサンプル数
int	samplingRate	サンプリングレート

Returns

Type	Description
bool	CriBool サンプル数が取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声について、サウンドバッファーへの書き込み済みサンプル数、およびサンプリングレートを返します。本関数は GetNumPlayedSamples(out long, out int) 関数と異なり、サウンドバッファーに書き込まれた未出力の音声データのサンプル数を含む値を返します。書き込み済みサンプル数が取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。（エラー発生時は num_samples や sampling_rate の値も負値になります。）

備考: 書き込み済みサンプル数の値の精度は、プラットフォーム SDK のサウンドライブラリに依存します。（プラットフォームによって、書き込み済みサンプル数の正確さは異なります。）複数の音声データを含むキューを再生した場合、最初に見つかった音声データの情報が返されます。

注意: ドライブでリードリトライ処理等が発生し、音声データの供給が途切れた場合、書き込み済みサンプル数のカウントアップが停止します。（データ供給が再開されれば、カウントアップが再開されます。）本関数は、音声再生中のみ書き込み済みサンプル数を取得可能です。再生終了後や、発音数制御によりボイスが消去された場合には、書き込み済みサンプル数の取得に失敗します。

GetParameterFloat32(ParameterId, out float)

LE Pro

パラメータの取得（浮動小数点数）

Declaration

public bool GetParameterFloat32(CriAtomEx.ParameterId parameterId, out float valueFloat32)

Parameters

Type	Name	Description
CriAtomEx.ParameterId	parameterId	パラメーターID
float	valueFloat32	パラメーター設定値

Returns

Type	Description
bool	パラメーターが取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声に設定されている各種パラメーターの値を取得します。値は浮動小数点数で取得されます。パラメーターが取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

注意: 本関数は、音声再生中のみパラメーターを取得可能です。再生終了後や、発音数制御によりボイスが消去された場合には、パラメーターの取得に失敗します。

Declaration

public bool GetParameterSint32(CriAtomEx.ParameterId parameterId, out int valueSint32)

Parameters

Type	Name	Description
CriAtomEx.ParameterId	parameterId	パラメーターID
int	valueSint32	パラメーター設定値

Returns

Type	Description
bool	パラメーターが取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声に設定されている各種パラメーターの値を取得します。値は符号付き整数で取得されます。パラメーターが取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

Declaration

public bool GetParameterUint32(CriAtomEx.ParameterId parameterId, out uint valueUint32)

Parameters

Type	Name	Description
CriAtomEx.ParameterId	parameterId	パラメーターID
uint	valueUint32	パラメーター設定値

Returns

Type	Description
bool	パラメーターが取得できたかどうか（ true = 取得できた、 false = 取得できなかった）

Remarks

説明: Start() 関数で再生された音声に設定されている各種パラメーターの値を取得します。値は符号なし整数で取得されます。パラメーターが取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

GetPlaybackTrackInfo(out TrackInfo)

LE Pro

再生トラック情報の取得

Declaration

public bool GetPlaybackTrackInfo(out CriAtomExPlayback.TrackInfo info)

Parameters

Type	Name	Description
CriAtomExPlayback.TrackInfo	info	再生トラック情報

Returns

Type	Description
bool	CriBool 成功／失敗

Remarks

説明: 再生中のキューのトラック情報を取得します。取得できるトラック情報はキュー直下の情報だけです。サブシーケンスやキューリンクの情報は取得できません。

備考: 以下に該当するデータを再生中の場合、トラック情報の取得に失敗します。

キュー以外のデータを再生している。（トラック情報が存在しないため）
再生中のキューがポリフォニックタイプ、またはセレクター参照のスイッチタイプである。（トラック情報が複数存在する可能性があるため）
再生中のキューがトラック遷移タイプである。（遷移により再生トラックが変わるため）

GetSequencePosition()

LE Pro

シーケンス再生位置の取得

Declaration

public long GetSequencePosition()

Returns

Type	Description
long	Sint64 シーケンス再生位置（ミリ秒単位）

Remarks

説明: Start() 関数で再生された音声のシーケンス再生位置を取得します。再生位置が取得できた場合、本関数は 0 以上の値を返します。指定したシーケンスが既に消去されている場合等には、本関数は負値を返します。

備考: 本関数が返す再生時刻は「シーケンスデータ上の再生位置」です。シーケンスループや、ブロック遷移を行った場合は、巻き戻った値が返ります。キュー指定以外での再生ではシーケンサーが動作しません。キュー再生以外の再生に対して本関数は負値を返します。 Pause(NativeBool) 関数でポーズをかけた場合、再生位置の更新も停止します。（ポーズを解除すれば再度更新が再開されます。）本関数で取得可能な時刻の精度は、サーバー処理の周波数に依存します。（時刻の更新はサーバー処理単位で行われます。）

注意: 戻り値の型はCriSint64ですが、現状、32bit以上の精度はありません。再生位置を元に制御を行う場合、シーケンスループ等の設定がないデータでは約24日で再生位置が異常になる点に注意が必要です。（ 2147483647 ミリ秒を超えた時点で、再生位置がオーバーフローし、負値になります。）本関数は、音声再生中のみ位置を取得可能です。再生終了後や、発音数制御によりシーケンスが消去された場合には、再生位置の取得に失敗します。（負値が返ります。）

GetSource(out SourceInfo)

LE Pro

再生音声の再生元情報の取得

Declaration

public bool GetSource(out CriAtomEx.SourceInfo source)

Parameters

Type	Name	Description
CriAtomEx.SourceInfo	source	再生元情報

Returns

Type	Description
bool

Remarks

説明: Start() 関数で再生された音声の再生元情報を取得します。取得した情報を元に、GetCueInfoByIndex(int, out CueInfo) 関数等を利用することで、より詳細な情報を取得することができます。再生元情報が取得できた場合、本関数は true を返します。指定したボイスが既に消去されている場合等には、本関数は false を返します。

備考再生元のタイプによって、取得できる情報が異なります。 typeを参照し、共用体sourceの中のどの構造体としてアクセスするかを選択してください。

注意: 本関数は、音声再生中のみ再生元情報を取得可能です。再生終了後や、発音数制御によりボイスが消去された場合には、再生元情報の取得に失敗します。

Declaration

public CriAtomExPlayback.Status GetStatus()

Returns

Type	Description
CriAtomExPlayback.Status	CriAtomExPlayback.Status 再生ステータス

Remarks

説明: Start() 関数で再生された音声のステータスを取得します。

備考: GetStatus() 関数がAtomExプレーヤーのステータスを返すのに対し、本関数は再生済みの個々の音声のステータスを取得します。再生中の音声のボイスリソースは、以下の場合に削除されます。

再生が完了した場合。
Stop() 関数で再生中の音声を停止した場合。
高プライオリティの発音リクエストにより再生中のボイスが奪い取られた場合。
再生中にエラーが発生した場合。

Stop() Removed

そのため、関数を使用して明示的に再生を停止したか、その他の要因によって再生が停止されたかの違いに関係なく、再生音のステータスはいずれの場合もに遷移します。（エラーの発生を検知する必要がある場合には、本関数ではなく、GetStatus() 関数で AtomEx プレーヤーのステータスをチェックする必要があります。）

GetTime()

LE Pro

再生時刻の取得

Declaration

public long GetTime()

Returns

Type	Description
long	Sint64 再生時刻（ミリ秒単位）

Remarks

説明: Start() 関数で再生された音声の再生時刻を取得します。再生時刻が取得できた場合、本関数は 0 以上の値を返します。指定したボイスが既に消去されている場合等には、本関数は負値を返します。

備考: 本関数が返す再生時刻は「再生開始後からの経過時間」です。ループ再生時や、シームレス連結再生時を行った場合でも、再生位置に応じて時刻が巻き戻ることはありません。 Pause(NativeBool) 関数でポーズをかけた場合、再生時刻のカウントアップも停止します。（ポーズを解除すれば再度カウントアップが再開されます。）本関数で取得可能な時刻の精度は、サーバー処理の周波数に依存します。（時刻の更新はサーバー処理単位で行われます。）より精度の高い時刻を取得する必要がある場合には、本関数の代わりに GetNumPlayedSamples(out long, out int) 関数を使用し、再生済みサンプル数を取得してください。

注意: 戻り値の型はCriSint64ですが、現状、32bit以上の精度はありません。再生時刻を元に制御を行う場合、約24日で再生時刻が異常になる点に注意が必要です。（ 2147483647 ミリ秒を超えた時点で、再生時刻がオーバーフローし、負値になります。）本関数は、音声再生中のみ時刻を取得可能です。（ GetTime() 関数と異なり、本関数は再生中の音声ごとに時刻を取得可能ですが、再生終了時刻を取ることができません。）再生終了後や、発音数制御によりボイスが消去された場合には、再生時刻の取得に失敗します。（負値が返ります。）ドライブでリードリトライ処理等が発生し、一時的に音声データの供給が途切れた場合でも、再生時刻のカウントアップが途切れることはありません。（データ供給停止により再生が停止した場合でも、時刻は進み続けます。）そのため、本関数で取得した時刻を元に映像との同期を行った場合、リードリトライ発生毎に同期が大きくズレる可能性があります。波形データと映像の同期を厳密に取る必要がある場合は、本関数の代わりに GetNumPlayedSamples(out long, out int) 関数を使用し、再生済みサンプル数との同期を取ってください。

GetTimeSyncedWithAudio()

LE Pro

再生時刻の取得（再生音声に同期した補正込み）

Declaration

public long GetTimeSyncedWithAudio()

Returns

Type	Description
long	Sint64 再生時刻（ミリ秒単位）

Remarks

備考: GetTime() 関数が返す「再生開始後からの経過時間」とは異なり、本関数からは再生中の音声に同期した再生時刻を取得することが可能です。デバイスのリードリトライ処理等により音声データの供給が途切れて再生が停止した場合、またはシステムの割り込みにより音声出力が妨げられた場合には、再生時刻のカウントアップが一時的に停止します。再生された音声に厳密に同期した処理を行いたい場合は、本関数で取得した再生時刻を用いてください。ただし、ループ再生時や、シームレス連結再生時に行った場合でも、再生位置に応じて時刻が巻き戻ることはありません。また、波形の詰まっていないシーケンスキューや再生波形が切り替わるブロックシーケンスキューに対しては、正常に再生時刻を取得することができません。 Pause(NativeBool) 関数でポーズをかけた場合、再生時刻のカウントアップも停止します。（ポーズを解除すれば再度カウントアップが再開されます。）本関数による再生時刻の取得を行う場合は、対応するAtomExプレーヤー作成時に、 CriAtomExPlayer.Config 構造体の enable_audio_synced_timer を true に設定してください。デフォルトでは無効になっています。戻り値の型は long ですが、現状、32bit以上の精度はありません。再生時刻を元に制御を行う場合、約24日で再生時刻が異常になる点に注意が必要です。（ 2147483647 ミリ秒を超えた時点で、再生時刻がオーバーフローし、負値になります。）本関数は、音声再生中のみ時刻を取得可能です。（ GetTime() 関数と異なり、本関数は再生中の音声ごとに時刻を取得可能ですが、再生終了時刻を取ることができません。）再生終了後や、発音数制御によりボイスが消去された場合には、再生時刻の取得に失敗します。（負値が返ります。）本関数は内部で時刻計算を行っており、プラットフォームによっては処理負荷が問題になる可能性があります。また、アプリケーションの同じフレーム内であっても、呼び出し毎に更新された時刻を返します。アプリケーションによる再生時刻の利用方法にもよりますが、基本的に本関数を用いた時刻取得は1フレームにつき一度のみ行うようにしてください。

GetTimeSyncedWithAudioMicro()

LE Pro

再生時刻の取得（再生音声に同期した補正込み）

Declaration

public long GetTimeSyncedWithAudioMicro()

Returns

Type	Description
long	Sint64 再生時刻（マイクロ秒単位）

Remarks

備考: GetTime() 関数が返す「再生開始後からの経過時間」とは異なり、本関数からは再生中の音声に同期した再生時刻を取得することが可能です。デバイスのリードリトライ処理等により音声データの供給が途切れて再生が停止した場合、またはシステムの割り込みにより音声出力が妨げられた場合には、再生時刻のカウントアップが一時的に停止します。再生された音声に厳密に同期した処理を行いたい場合は、本関数で取得した再生時刻を用いてください。ただし、ループ再生時や、シームレス連結再生時に行った場合でも、再生位置に応じて時刻が巻き戻ることはありません。また、波形の詰まっていないシーケンスキューや再生波形が切り替わるブロックシーケンスキューに対しては、正常に再生時刻を取得することができません。 Pause(NativeBool) 関数でポーズをかけた場合、再生時刻のカウントアップも停止します。（ポーズを解除すれば再度カウントアップが再開されます。）本関数による再生時刻の取得を行う場合は、対応するAtomExプレーヤー作成時に、 CriAtomExPlayer.Config 構造体の enable_audio_synced_timer を true に設定してください。デフォルトでは無効になっています。本関数は、音声再生中のみ時刻を取得可能です。（ GetTime() 関数と異なり、本関数は再生中の音声ごとに時刻を取得可能ですが、再生終了時刻を取ることができません。）再生終了後や、発音数制御によりボイスが消去された場合には、再生時刻の取得に失敗します。（負値が返ります。）本関数は内部で時刻計算を行っており、プラットフォームによっては処理負荷が問題になる可能性があります。また、アプリケーションの同じフレーム内であっても、呼び出し毎に更新された時刻を返します。アプリケーションによる再生時刻の利用方法にもよりますが、基本的に本関数を用いた時刻取得は1フレームにつき一度のみ行うようにしてください。

IsPaused()

LE Pro

再生音のポーズ状態の取得

Declaration

public bool IsPaused()

Returns

Type	Description
bool	CriBool ポーズ中かどうか（false = ポーズされていない、true = ポーズ中）

Remarks

説明: 再生中の音声がポーズ中かどうかを返します。

Declaration

public void Pause(NativeBool sw)

Parameters

Type	Name	Description
NativeBool	sw	スイッチ（ CRI_FALSE = ポーズ解除、 CRI_TRUE = ポーズ）

Remarks

説明: 再生音単位でポーズ／ポーズ解除を行います。 sw に true を指定して本関数を実行すると、指定したIDの音声がポーズ（一時停止）されます。 sw に false を指定して本関数を実行すると、指定したIDの音声のポーズが解除され、一時停止していた音声の再生が再開されます。本関数を使用することで、プレーヤーによって再生された音声を、プレーヤー単位ではなく、個別にポーズ／ポーズ解除させることが可能です。

備考: プレーヤーによって再生された全ての音声をポーズ／ポーズ解除したい場合、本関数ではなく Pause(NativeBool) 関数をご利用ください。フェーダーをアタッチしたプレーヤーで再生した音声に対して本関数で個別にポーズ／ポーズ解除の操作を行った場合、クロスフェード処理はフェードイン側の音声のポーズ状態に同期して行われます。例えば、クロスフェード中にPause(NativeBool) 関数で両方の音声をポーズした場合、フェードイン側の音声のポーズを解除すればクロスフェード処理が再開されますが、フェードアウト側の音声のポーズを解除してもクロスフェード処理は再開されません。

注意: 第2引数（sw）に false を指定してポーズ解除の操作を行った場合、本関数でポーズをかけた音声だけでなく、Prepare() 関数で再生準備中の音声についても再生が開始されてしまいます。（旧バージョンとの互換性維持のための仕様です。）本関数でポーズをかけた音声についてのみポーズを解除したい場合、本関数を使用せず、 Resume(ResumeMode)(id, PausedPlayback); を実行してポーズ解除を行ってください。フェーダーをアタッチしたプレーヤーに対し再生ID指定でポーズの解除を行うと、フェードインする音声の発音リソースが確保できない場合や、フェードインする音声の発音リソースが奪い取られた場合にポーズ解除が行えず、フェードアウト側の音声がいつまで経ってもフェードアウトしない状態となります。フェーダーをアタッチしたプレーヤーで再生した音声に対しては、本関数ではなく、 Pause(NativeBool) 関数でポーズの解除を行ってください。

Declaration

public void Resume(CriAtomEx.ResumeMode mode)

Parameters

Type	Name	Description
CriAtomEx.ResumeMode	mode	ポーズ解除対象

Remarks

説明: 再生音単位で一時停止状態の解除を行います。 Pause(NativeBool) 関数と異なり、 Prepare() 関数で再生開始待ちの音声と、 Pause(NativeBool) 関数（または Pause(NativeBool) 関数でポーズをかけた音声とを、個別に再開させることが可能です。第2引数（mode）に PausedPlayback を指定して本関数を実行すると、ユーザが Pause(NativeBool) 関数（または Pause(NativeBool) 関数）で一時停止状態になった音声の再生が再開されます。第2引数（mode）に PreparedPlayback を指定して本関数を実行すると、ユーザが Prepare() 関数で再生準備を指示した音声の再生が開始されます。 Pause(NativeBool) 関数でポーズ状態のプレーヤーに対して Prepare() 関数で再生準備を行った場合、その音声は PausedPlayback 指定のポーズ解除処理と、 PreparedPlayback 指定のポーズ解除処理の両方が行われるまで、再生が開始されません。

備考: フェーダーをアタッチしたプレーヤーで再生した音声に対して本関数で個別にポーズ解除の操作を行った場合、クロスフェード処理はフェードイン側の音声のポーズ状態に同期して行われます。例えば、クロスフェード中にPause(NativeBool) 関数で両方の音声をポーズした場合、フェードイン側の音声のポーズを解除すればクロスフェード処理が再開されますが、フェードアウト側の音声のポーズを解除してもクロスフェード処理は再開されません。

注意: フェーダーをアタッチしたプレーヤーに対し再生ID指定でポーズの解除を行うと、フェードインする音声の発音リソースが確保できない場合や、フェードインする音声の発音リソースが奪い取られた場合にポーズ解除が行えず、フェードアウト側の音声がいつまで経ってもフェードアウトしない状態となります。フェーダーをアタッチしたプレーヤーで再生した音声に対しては、本関数ではなく、 Pause(NativeBool) 関数でポーズの解除を行ってください。

SetBeatSyncOffset(short)

LE Pro

ビート同期オフセットの設定

Declaration

public bool SetBeatSyncOffset(short timeMs)

Parameters

Type	Name	Description
short	timeMs	オフセット時間

Returns

Type	Description
bool	CriBool 成功／失敗

Remarks

説明: 再生中のキューのビート同期オフセットを設定します。キューにはビート同期情報が設定されている必要があります。キューリンクやスタートアクションで再生しているキューへの設定はできません。

備考: 以下に該当するデータを再生中の場合、ビート同期オフセットの設定に失敗します。

キュー以外のデータを再生している。（ビート同期情報が存在しないため）
ビート同期情報が設定されていないキューを再生している。
ビート同期情報が設定されているキューを"間接的"に再生している。（キューリンクやスタートアクションで再生している）

SetNextBlockIndex(int)

LE Pro

再生音のブロック遷移

Declaration

public void SetNextBlockIndex(int index)

Parameters

Type	Name	Description
int	index	ブロックインデックス

Remarks

説明: 再生音単位でブロック遷移を行います。本関数を実行すると、指定したIDの音声がブロックシーケンスの場合はデータの設定に従った任意の遷移タイミングで指定ブロックに遷移します。

備考: 再生開始ブロックの指定は SetFirstBlockIndex(int) 関数を使用して行い、再生中のブロックインデックス取得は GetCurrentBlockIndex() 関数を使用します。

Stop()

LE Pro

再生音の停止

Declaration

public void Stop()

Remarks

説明: 再生音単位で停止処理を行います。本関数を使用することで、プレーヤーによって再生された音声を、プレーヤー単位ではなく、個別に停止させることが可能です。

備考: AtomEx プレーヤーによって再生された全ての音声を停止したい場合、本関数ではなく Stop() 関数をご利用ください。（ Stop() 関数は、そのプレーヤーで再生中の全ての音声を停止します。）

注意: 本関数で再生音の停止を行うと、再生中の音声のステータスは Removed に遷移します。停止時にボイスリソースも破棄されるため、一旦 Removed 状態に遷移した再生 ID からは、以降情報を取得できなくなります。

StopWithoutReleaseTime()

LE Pro

再生音の停止（リリースタイム無視）

Declaration

public void StopWithoutReleaseTime()

Remarks

説明: 再生音単位で停止処理を行います。この際、再生中の音声にエンベロープのリリースタイムが設定されていたとしても、それを無視して停止します。本関数を使用することで、プレーヤーによって再生された音声を、プレーヤー単位ではなく、個別に停止させることが可能です。

備考: プレーヤーによって再生された全ての音声を停止したい場合、本関数ではなく StopWithoutReleaseTime() 関数をご利用ください。

Struct CriAtomExPlayback

Inherited Members

Namespace: CriWare

Assembly: CriWare.CriAtom.dll

Syntax

Remarks

Properties

Invalid

Declaration

Property Value

NativeHandle

Declaration

Property Value

Methods

GetAisacControlById(uint, out float)

Declaration

Parameters

Returns

Remarks

See Also

GetAisacControlByName(ArgString, out float)

Declaration

Parameters

Returns

Remarks

See Also

GetAtomPlayer()

Declaration

Returns

Remarks

GetBeatSyncInfo(out Info)

Declaration

Parameters

Returns

Remarks

GetCurrentBlockIndex()

Declaration

Returns

Remarks

See Also

GetFormatInfo(out FormatInfo)

Declaration

Parameters

Returns

Remarks

See Also

GetNumPlayedSamples(out long, out int)

Declaration

Parameters

Returns

Remarks

See Also

GetNumRenderedSamples(out long, out int)

Declaration

Parameters

Returns

Remarks

See Also

GetParameterFloat32(ParameterId, out float)

Declaration

Parameters

Returns

Remarks

See Also

GetParameterSint32(ParameterId, out int)

Declaration

Parameters

Returns

Remarks

See Also

GetParameterUint32(ParameterId, out uint)

Declaration

Parameters

Returns

Remarks

See Also

GetPlaybackTrackInfo(out TrackInfo)

Declaration

Parameters

Returns