AudioTrack.Write メソッド

リファレンス

定義

名前空間:: Android.Media

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Write(ByteBuffer, Int32, WriteMode)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。
Write(Byte[], Int32, Int32)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。
Write(Int16[], Int32, Int32)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。
Write(ByteBuffer, Int32, WriteMode, Int64)	オーディオデータをオーディオシンクに書き込み、HW_AV_SYNC トラックのストリーミングモードで再生します。
Write(Byte[], Int32, Int32, WriteMode)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。
Write(Int16[], Int32, Int32, WriteMode)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。
Write(Single[], Int32, Int32, WriteMode)	オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。

Write(ByteBuffer, Int32, WriteMode)

オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。

[Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;II)I", "GetWrite_Ljava_nio_ByteBuffer_IIHandler")]
public virtual int Write (Java.Nio.ByteBuffer audioData, int sizeInBytes, Android.Media.WriteMode writeMode);

[<Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;II)I", "GetWrite_Ljava_nio_ByteBuffer_IIHandler")>]
abstract member Write : Java.Nio.ByteBuffer * int * Android.Media.WriteMode -> int
override this.Write : Java.Nio.ByteBuffer * int * Android.Media.WriteMode -> int

パラメーター

audioData: ByteBuffer

によって報告 audioData.position()された位置から開始して、書き込むデータを保持するバッファー。 戻り時に、AudioTrack に正常に書き込まれたデータの量を反映するようにバッファー位置 (audioData.position()) が進んでいることに注意してください。

sizeInBytes: Int32

書き込むバイト数。要求されたバイト数をフレームサイズの倍数 (サンプルサイズ (バイト単位) にチャネル数を掛けた値) にすることをお勧めしますが、適用されません。 これはと異なる audioData.remaining()場合がありますが、それを超えることはできません。

writeMode: WriteMode

、 #WRITE_NON_BLOCKINGのいずれか#WRITE_BLOCKING。静的モードでは効果がありません。 では #WRITE_BLOCKING、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 を使用すると #WRITE_NON_BLOCKING、書き込みは、ブロックすることなく、できるだけ多くのオーディオデータを再生するためにキューに入った直後に返されます。

戻り値

Int32

0 または書き込まれた正のバイト数、または次のいずれかのエラーコード。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li</ul の場合、次の write()</li li><#ERROR> でエラーが<返されます>>

属性: RegisterAttribute

注釈

オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。 ByteBuffer の audioData は、AudioTrack コンストラクターで指定された形式と一致する必要があります。

ストリーミングモードでは、ブロック動作は書き込みモードによって異なります。書き込みモードがの #WRITE_BLOCKING場合、通常、すべてのデータが再生用にエンキューされるまで書き込みはブロックされ、完全な転送カウントが返されます。ただし、書き込みモードが #WRITE_NON_BLOCKINGの場合、またはトラックがエントリで停止または一時停止している場合、または別のスレッドが停止または一時停止を呼び出して書き込みを中断した場合、または書き込み中に I/O エラーが発生した場合、書き込みでは短い転送カウントが返される可能性があります。

静的バッファーモードでは、オフセット 0 からバッファーにデータがコピーされ、書き込みモードは無視されます。このデータの実際の再生は、この関数が戻った後に発生する可能性があることに注意してください。

の Java ドキュメント android.media.AudioTrack.write(java.nio.ByteBuffer, int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(Byte[], Int32, Int32)

[Android.Runtime.Register("write", "([BII)I", "GetWrite_arrayBIIHandler")]
public virtual int Write (byte[] audioData, int offsetInBytes, int sizeInBytes);

[<Android.Runtime.Register("write", "([BII)I", "GetWrite_arrayBIIHandler")>]
abstract member Write : byte[] * int * int -> int
override this.Write : byte[] * int * int -> int

パラメーター

audioData: Byte[]

再生するデータを保持する配列。

offsetInBytes: Int32

書き込むデータが開始される audioData のバイト単位で表されるオフセット。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

sizeInBytes: Int32

オフセットの後の audioData に書き込むバイト数。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

戻り値

Int32

0 または書き込まれた正のバイト数、または次のいずれかのエラーコード。バイト数は、sizeInBytes を超えないフレームサイズの倍数 (バイト単位) になります。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li></ul> の場合、次の write()</li li#ERROR>>< でエラー<が返されます。これはに設定されている #WRITE_BLOCKINGとwriteMode同じです。#write(byte[], int, int, int)

属性: RegisterAttribute

注釈

オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。 AudioTrack コンストラクターで指定される形式は、 AudioFormat#ENCODING_PCM_8BIT 配列内のデータに対応するようにする必要があります。形式にはを指定 AudioFormat#ENCODING_PCM_16BITできますが、これは非推奨です。

ストリーミングモードでは、通常、すべてのデータが再生用にエンキューされるまで書き込みがブロックされ、完全な転送カウントが返されます。ただし、トラックがエントリで停止または一時停止されている場合、または別のスレッドが停止または一時停止を呼び出して書き込みを中断した場合、または書き込み中に I/O エラーが発生した場合、書き込みは短い転送カウントを返す可能性があります。

静的バッファーモードでは、オフセット 0 から始まるバッファーにデータをコピーします。このデータの実際の再生は、この関数が戻った後に発生する可能性があることに注意してください。

の Java ドキュメント android.media.AudioTrack.write(byte[], int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(Int16[], Int32, Int32)

[Android.Runtime.Register("write", "([SII)I", "GetWrite_arraySIIHandler")]
public virtual int Write (short[] audioData, int offsetInShorts, int sizeInShorts);

[<Android.Runtime.Register("write", "([SII)I", "GetWrite_arraySIIHandler")>]
abstract member Write : int16[] * int * int -> int
override this.Write : int16[] * int * int -> int

パラメーター

audioData: Int16[]

再生するデータを保持する配列。

offsetInShorts: Int32

再生するデータが開始される audioData のショーツで表されるオフセット。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

sizeInShorts: Int32

オフセットの後に audioData で読み取るショーツの数。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

戻り値

Int32

0 または書き込まれたショーツの正の数、または次のいずれかのエラーコード。ショーツの数は、sizeInShorts を超えないチャネル数の倍数になります。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li></ul> の場合、次の write()</li li#ERROR>>< でエラー<が返されます。これはに設定されている #WRITE_BLOCKINGとwriteMode同じです。#write(short[], int, int, int)

属性: RegisterAttribute

注釈

オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。 AudioTrack コンストラクターで指定される形式は、 AudioFormat#ENCODING_PCM_16BIT 配列内のデータに対応するようにする必要があります。

の Java ドキュメント android.media.AudioTrack.write(short[], int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(ByteBuffer, Int32, WriteMode, Int64)

オーディオデータをオーディオシンクに書き込み、HW_AV_SYNC トラックのストリーミングモードで再生します。

[Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;IIJ)I", "GetWrite_Ljava_nio_ByteBuffer_IIJHandler", ApiSince=23)]
public virtual int Write (Java.Nio.ByteBuffer audioData, int sizeInBytes, Android.Media.WriteMode writeMode, long timestamp);

[<Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;IIJ)I", "GetWrite_Ljava_nio_ByteBuffer_IIJHandler", ApiSince=23)>]
abstract member Write : Java.Nio.ByteBuffer * int * Android.Media.WriteMode * int64 -> int
override this.Write : Java.Nio.ByteBuffer * int * Android.Media.WriteMode * int64 -> int

パラメーター

audioData: ByteBuffer

sizeInBytes: Int32

writeMode: WriteMode

、 #WRITE_NON_BLOCKINGのいずれか#WRITE_BLOCKING。 では #WRITE_BLOCKING、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 を使用すると #WRITE_NON_BLOCKING、書き込みは、ブロックすることなく、できるだけ多くのオーディオデータを再生するためにキューに入った直後に返されます。

timestamp: Int64

指定された audioData 内の最初のデコード可能なオーディオフレームのタイムスタンプ (ナノ秒単位)。

戻り値

Int32

属性: RegisterAttribute

注釈

オーディオデータをオーディオシンクに書き込み、HW_AV_SYNC トラックのストリーミングモードで再生します。ブロック動作は書き込みモードによって異なります。

の Java ドキュメント android.media.AudioTrack.write(java.nio.ByteBuffer, int, int, long)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(Byte[], Int32, Int32, WriteMode)

[Android.Runtime.Register("write", "([BIII)I", "GetWrite_arrayBIIIHandler", ApiSince=23)]
public virtual int Write (byte[] audioData, int offsetInBytes, int sizeInBytes, Android.Media.WriteMode writeMode);

[<Android.Runtime.Register("write", "([BIII)I", "GetWrite_arrayBIIIHandler", ApiSince=23)>]
abstract member Write : byte[] * int * int * Android.Media.WriteMode -> int
override this.Write : byte[] * int * int * Android.Media.WriteMode -> int

パラメーター

audioData: Byte[]

再生するデータを保持する配列。

offsetInBytes: Int32

sizeInBytes: Int32

オフセットの後の audioData に書き込むバイト数。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

writeMode: WriteMode

、 #WRITE_NON_BLOCKINGのいずれか#WRITE_BLOCKING。静的モードでは効果がありません。 では #WRITE_BLOCKING、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 を使用すると #WRITE_NON_BLOCKING、書き込みは、できるだけ多くのオーディオデータをキューに入れ、ブロックせずに再生した直後に返されます。

戻り値

Int32

0 または書き込まれた正のバイト数、または次のいずれかのエラーコード。バイト数は、sizeInBytes を超えないフレームサイズの倍数 (バイト単位) になります。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li</ul の場合、次の write()</li li><#ERROR> でエラーが<返されます>>

属性: RegisterAttribute

注釈

の Java ドキュメント android.media.AudioTrack.write(byte[], int, int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(Int16[], Int32, Int32, WriteMode)

[Android.Runtime.Register("write", "([SIII)I", "GetWrite_arraySIIIHandler", ApiSince=23)]
public virtual int Write (short[] audioData, int offsetInShorts, int sizeInShorts, Android.Media.WriteMode writeMode);

[<Android.Runtime.Register("write", "([SIII)I", "GetWrite_arraySIIIHandler", ApiSince=23)>]
abstract member Write : int16[] * int * int * Android.Media.WriteMode -> int
override this.Write : int16[] * int * int * Android.Media.WriteMode -> int

パラメーター

audioData: Int16[]

書き込むデータを保持する配列。

offsetInShorts: Int32

書き込むデータが開始される audioData のショーツで表されるオフセット。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

sizeInShorts: Int32

オフセットの後に audioData で読み取るショーツの数。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

writeMode: WriteMode

戻り値

Int32

0 または書き込まれたショーツの正の数、または次のいずれかのエラーコード。ショーツの数は、sizeInShorts を超えないチャネル数の倍数になります。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li</ul の場合、次の write()</li li><#ERROR> でエラーが<返されます>>

属性: RegisterAttribute

注釈

の Java ドキュメント android.media.AudioTrack.write(short[], int, int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

Write(Single[], Int32, Int32, WriteMode)

[Android.Runtime.Register("write", "([FIII)I", "GetWrite_arrayFIIIHandler")]
public virtual int Write (float[] audioData, int offsetInFloats, int sizeInFloats, Android.Media.WriteMode writeMode);

[<Android.Runtime.Register("write", "([FIII)I", "GetWrite_arrayFIIIHandler")>]
abstract member Write : single[] * int * int * Android.Media.WriteMode -> int
override this.Write : single[] * int * int * Android.Media.WriteMode -> int

パラメーター

audioData: Single[]

書き込むデータを保持する配列。オーディオパイプラインのすべての利益が unity (1.0f) 以下であり、リバーブなどのエネルギーを追加する可能性のある後処理効果がない場合、実装では、標準範囲内 [-1.0f, 1.0f] 内のサンプル値はクリップされません。 Unity 以外のゲインを持つフィルターを使用してサンプルを計算するアプリケーションの利便性のために、標準範囲を超える +3 dB のサンプル値が許可されます。ただし、オーディオパス内のさまざまなゲインと後の処理に応じて、このような値は最終的に制限またはクリップされる可能性があります。したがって、アプリケーションは、標準範囲内のサンプル値を提供することをお勧めします。

offsetInFloats: Int32

書き込むデータが開始される audioData で、浮動小数点数で表されるオフセット。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

sizeInFloats: Int32

オフセットの後の audioData に書き込む浮動小数点数の数。負の値にしたり、データアクセスを配列の範囲外にしたりすることはできません。

writeMode: WriteMode

戻り値

Int32

0 または書き込まれた浮動小数点数の正の数、または次のいずれかのエラーコード。浮動小数点数の数は、sizeInFloats を超えないチャネル数の倍数になります。 <パラメーターが有効なデータに解決されず、AudioTrack が無効で再作成する必要がある場合は、<トラックが正しく初期化><<#ERROR_BAD_VALUE>されていない場合は ul><li/li<>li。#ERROR_DEAD_OBJECT>>#ERROR_INVALID_OPERATION 一部のデータが正常に転送された場合、配信不能オブジェクトのエラーコードは返されません。この場合、他のエラー/li</ul の場合、次の write()</li li><#ERROR> でエラーが<返されます>>

属性: RegisterAttribute

注釈

オーディオデータを再生用のオーディオシンク (ストリーミングモード) に書き込むか、後で再生するためにオーディオデータをコピーします (静的バッファーモード)。 AudioTrack コンストラクターで指定される形式は、 AudioFormat#ENCODING_PCM_FLOAT 配列内のデータに対応するようにする必要があります。

の Java ドキュメント android.media.AudioTrack.write(float[], int, int, int)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

AudioTrack.Write メソッド

定義

オーバーロード

Write(ByteBuffer, Int32, WriteMode)

パラメーター

戻り値

注釈

適用対象

Write(Byte[], Int32, Int32)

パラメーター

戻り値

注釈

適用対象

Write(Int16[], Int32, Int32)

パラメーター

戻り値

注釈

適用対象

Write(ByteBuffer, Int32, WriteMode, Int64)

パラメーター

戻り値

注釈

適用対象

Write(Byte[], Int32, Int32, WriteMode)

パラメーター

戻り値

注釈

適用対象

Write(Int16[], Int32, Int32, WriteMode)

パラメーター

戻り値

注釈

適用対象

Write(Single[], Int32, Int32, WriteMode)

パラメーター

戻り値

注釈

適用対象

その他のリソース