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_BLOCKING#WRITE_NON_BLOCKING1 つ。静的モードでは効果がありません。 With では #WRITE_BLOCKING、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 With では #WRITE_NON_BLOCKING、書き込みでは、ブロックすることなく、できるだけ多くのオーディオデータを再生するためにキューに入った直後に書き込みが返されます。

戻り値

Int32

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

属性: RegisterAttribute

注釈

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

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

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

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

このページの一部は、Android オープンソースプロジェクトによって作成および共有され、クリエイティブコモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

適用対象

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 を超えないバイト単位のフレームサイズの倍数になります。 <トラックが正しく初期化されていない場合は ul><li<>#ERROR_INVALID_OPERATION#ERROR_BAD_VALUE>>、AudioTrack が無効で再作成する必要がある場合は、パラメーターが有効なデータとインデックス</li li#ERROR_DEAD_OBJECT>>< に解決されない場合は li li。< 一部のデータが正常に転送された場合、デッドオブジェクトのエラーコードは返されません。この場合、他のエラー/li>/ul> の場合、次の write()</li>#ERROR>< でエラー<が返されます。これは#write(byte[], int, int, int)#WRITE_BLOCKINGwriteMode、 .<

属性: 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 を超えないようにチャンネル数の倍数になります。 <トラックが正しく初期化されていない場合は ul><li<>#ERROR_INVALID_OPERATION#ERROR_BAD_VALUE>>、AudioTrack が無効で再作成する必要がある場合は、パラメーターが有効なデータとインデックス</li li#ERROR_DEAD_OBJECT>>< に解決されない場合は li li。< 一部のデータが正常に転送された場合、デッドオブジェクトのエラーコードは返されません。この場合、他のエラー/li>/ul> の場合、次の write()</li>#ERROR>< でエラー<が返されます。これは#write(short[], int, int, int)#WRITE_BLOCKINGwriteMode、 .<

属性: 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_BLOCKING#WRITE_NON_BLOCKING1 つ。 With では #WRITE_BLOCKING、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 With では #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_BLOCKING#WRITE_NON_BLOCKING1 つ。静的モードでは効果がありません。 With #WRITE_BLOCKINGでは、すべてのデータがオーディオシンクに書き込まれるまで書き込みがブロックされます。 With の #WRITE_NON_BLOCKING場合、書き込みでは、ブロックすることなく、できるだけ多くのオーディオデータを再生するためにキューに入った直後に書き込みが返されます。

戻り値

Int32

0 または書き込まれた正のバイト数、または次のいずれかのエラーコード。バイト数は、sizeInBytes を超えないバイト単位のフレームサイズの倍数になります。 <トラックが正しく初期化されていない場合は ul><li<>#ERROR_INVALID_OPERATION#ERROR_BAD_VALUE>>、AudioTrack が無効で再作成する必要がある場合は、パラメーターが有効なデータとインデックス</li li#ERROR_DEAD_OBJECT>>< に解決されない場合は li li。< 一部のデータが正常に転送された場合、デッドオブジェクトのエラーコードは返されません。この場合、他のエラー/li/ul の場合、エラーは次の write()</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 を超えないようにチャンネル数の倍数になります。 <トラックが正しく初期化されていない場合は ul><li<>#ERROR_INVALID_OPERATION#ERROR_BAD_VALUE>>、AudioTrack が無効で再作成する必要がある場合は、パラメーターが有効なデータとインデックス</li li#ERROR_DEAD_OBJECT>>< に解決されない場合は li li。< 一部のデータが正常に転送された場合、デッドオブジェクトのエラーコードは返されません。この場合、他のエラー/li/ul の場合、エラーは次の write()</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] 内のサンプル値をクリップしません。ユニティゲイン以外のフィルタを使用してサンプルを計算するアプリケーションでは、標準範囲を超えるサンプル値 +3 dB が許可されます。ただし、このような値は、オーディオパスのさまざまなゲインと後の処理に応じて、最終的に制限またはクリップされる可能性があります。したがって、アプリケーションは、標準範囲内のサンプル値を提供することをお勧めします。

offsetInFloats: Int32

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

sizeInFloats: Int32

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

writeMode: WriteMode

戻り値

Int32

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

パラメーター

戻り値

注釈

適用対象

その他のリソース