語言

AudioTrack.Write 方法

定義

多載

名稱 Description
Write(Single[], Int32, Int32, WriteMode)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

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)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

[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[]

這個陣列用來存放要寫入的資料。 只要音訊管線中的所有增益都大於或等於1(1.0f),且沒有後製效果(如混響等)會增加能量,則實作不會在標稱範圍內的取樣值(-1.0f, 1.0f)進行裁剪。 為了方便使用非單位增益濾波器計算取樣的應用,允許取樣值超過標稱範圍 +3 dB。 然而,這些數值最終可能會受到限制或削波,這取決於音訊路徑中的各種增益及後續處理。 因此,建議申請者提供標稱範圍內的樣本數值。

offsetInFloats
Int32

偏移量,以 audioData 中數個浮點表示,資料寫入起始位置。 不得為負值,或導致資料存取超出陣列範圍。

sizeInFloats
Int32

在偏移量後,需寫入 audioData 的浮點數。 不得為負值,或導致資料存取超出陣列範圍。

writeMode
WriteMode

其中#WRITE_BLOCKING之一。 #WRITE_NON_BLOCKING 靜態模式下沒有效果。 < >當 ,寫#WRITE_BLOCKING入會阻塞,直到所有資料都寫入音訊匯入。 < >br 當 時#WRITE_NON_BLOCKING,寫入會立即返回,並盡可能排隊播放的音訊資料且不會阻塞。

傳回

零,或是寫入的正數浮點數,或以下其中一種錯誤碼。 浮點數將是通道數的倍數,且不得超過 sizeInFloats。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 在這種情況下,若發生其他錯誤</li<>/ul,錯誤會在下一個 write()</li<>li>#ERROR 回傳>

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 AudioTrack 建構器中指定的格式應與 AudioFormat#ENCODING_PCM_FLOAT 陣列中的資料相符。

在串流模式下,阻擋行為取決於寫入模式。 若寫入模式為 #WRITE_BLOCKING,寫入通常會阻塞,直到所有資料都排隊播放,並回傳完整的傳輸計數。 然而,若寫入模式為 #WRITE_NON_BLOCKING,或軌道在進入時停止或暫停,或其他執行緒呼叫停止或暫停而中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳短傳輸計數。

在靜態緩衝區模式下,會從偏移量 0 開始將資料複製到緩衝區,寫入模式則被忽略。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(float[], int, int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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()報告的位置開始寫入。 <BR>請注意,回傳時緩衝區位置audioData.position()()會被推進,以反映成功寫入 AudioTrack 的資料量。

sizeInBytes
Int32

要寫入的位元組數。 建議但不強制要求的位元組數應為影格大小的整數倍(以位元組為單位的樣本數乘以通道數)。 <BR>注意這可能與 audioData.remaining()不同,但無法超過。

writeMode
WriteMode

其中#WRITE_BLOCKING之一。 #WRITE_NON_BLOCKING 靜態模式下沒有效果。 <BR>在 時 #WRITE_BLOCKING,寫入會阻塞,直到所有資料都寫入音訊匯入器。 <BR>使用 #WRITE_NON_BLOCKING,寫入會在排隊盡可能多的音訊資料以進行播放後立即返回,且不會阻塞。

傳回

零或寫入的正數位元組,或以下錯誤碼之一。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 在這種情況下,若發生其他錯誤</li<>/ul,錯誤會在下一個 write()</li<>li>#ERROR 回傳>

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 ByteBuffer 中的 audioData 應與 AudioTrack 建構器中指定的格式相符。

在串流模式下,阻擋行為取決於寫入模式。 若寫入模式為 #WRITE_BLOCKING,寫入通常會阻塞,直到所有資料都排隊播放,並回傳完整的傳輸計數。 然而,若寫入模式為 #WRITE_NON_BLOCKING,或軌道在進入時停止或暫停,或其他執行緒呼叫停止或暫停而中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳短傳輸計數。

在靜態緩衝區模式下,會從偏移量 0 開始將資料複製到緩衝區,寫入模式則被忽略。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(java.nio.ByteBuffer, int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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 的位元組數。 不得為負值,或導致資料存取超出陣列範圍。

傳回

零或寫入的正數位元組,或以下錯誤碼之一。 位元組數將是框架大小的倍數(以位元組為單位),但不會超過 sizeInBytes。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 此時錯誤於下一次 write()</li<>回傳;若有其他錯誤</li></ul>,則 li#ERROR> 返回。此等價#write(byte[], int, int, int)於設writeMode為 。#WRITE_BLOCKING

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 AudioTrack 建構器中指定的格式應與 AudioFormat#ENCODING_PCM_8BIT 陣列中的資料相符。 格式可以是 AudioFormat#ENCODING_PCM_16BIT,但已被棄用。

在串流模式下,寫入通常會阻塞,直到所有資料都排隊播放,然後回傳完整的傳輸計數。 然而,若軌道在進入時被停止或暫停,或其他執行緒呼叫停止或暫停中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳一個短暫的傳輸計數。

在靜態緩衝區模式下,會將資料從偏移量0開始複製到緩衝區。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(byte[], int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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

偏移後需讀取的短路數。 不得為負值,或導致資料存取超出陣列範圍。

傳回

零或為正數短路,或以下任一錯誤代碼。 短影片數量將以頻道數的倍數計算,且不超過 sizeInShorts。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 此時錯誤於下一次 write()</li<>回傳;若有其他錯誤</li></ul>,則 li#ERROR> 返回。此等價#write(short[], int, int, int)於設writeMode為 。#WRITE_BLOCKING

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 AudioTrack 建構器中指定的格式應與 AudioFormat#ENCODING_PCM_16BIT 陣列中的資料相符。

在串流模式下,寫入通常會阻塞,直到所有資料都排隊播放,然後回傳完整的傳輸計數。 然而,若軌道在進入時被停止或暫停,或其他執行緒呼叫停止或暫停中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳一個短暫的傳輸計數。

在靜態緩衝區模式下,會將資料從偏移量0開始複製到緩衝區。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(short[], int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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

儲存資料的緩衝區,從 所 audioData.position()報告的位置開始寫入。 <BR>請注意,回傳時緩衝區位置audioData.position()()會被推進,以反映成功寫入 AudioTrack 的資料量。

sizeInBytes
Int32

要寫入的位元組數。 建議但不強制要求的位元組數應為影格大小的整數倍(以位元組為單位的樣本數乘以通道數)。 <BR>注意這可能與 audioData.remaining()不同,但無法超過。

writeMode
WriteMode

其中#WRITE_BLOCKING之一。 #WRITE_NON_BLOCKING <BR>在 時 #WRITE_BLOCKING,寫入會阻塞,直到所有資料都寫入音訊匯入器。 <BR>使用 #WRITE_NON_BLOCKING,寫入會在排隊盡可能多的音訊資料以進行播放後立即返回,且不會阻塞。

timestamp
Int64

提供音訊資料中第一個可解碼音訊影格的時間戳,單位為奈秒。

傳回

零或寫入的正數位元組,或以下錯誤碼之一。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 在這種情況下,若發生其他錯誤</li<>/ul,錯誤會在下一個 write()</li<>li>#ERROR 回傳>

屬性

備註

將音訊資料寫入音訊匯入,在串流模式下播放HW_AV_SYNC軌。阻塞行為會依寫入模式而異。

Java 文件 android.media.AudioTrack.write(java.nio.ByteBuffer, int, int, long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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

偏移量以 audioData 中位元組表示,資料寫入起始處。 不得為負值,或導致資料存取超出陣列範圍。

sizeInBytes
Int32

偏移量後需寫入 audioData 的位元組數。 不得為負值,或導致資料存取超出陣列範圍。

writeMode
WriteMode

其中#WRITE_BLOCKING之一。 #WRITE_NON_BLOCKING 靜態模式下沒有效果。 < >當 ,寫#WRITE_BLOCKING入會阻塞,直到所有資料都寫入音訊匯入。 < >br 當 時#WRITE_NON_BLOCKING,寫入會立即返回,並盡可能排隊播放的音訊資料且不會阻塞。

傳回

零或寫入的正數位元組,或以下錯誤碼之一。 位元組數將是框架大小的倍數(以位元組為單位),但不會超過 sizeInBytes。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 在這種情況下,若發生其他錯誤</li<>/ul,錯誤會在下一個 write()</li<>li>#ERROR 回傳>

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 AudioTrack 建構器中指定的格式應與 AudioFormat#ENCODING_PCM_8BIT 陣列中的資料相符。 格式可以是 AudioFormat#ENCODING_PCM_16BIT,但已被棄用。

在串流模式下,阻擋行為取決於寫入模式。 若寫入模式為 #WRITE_BLOCKING,寫入通常會阻塞,直到所有資料都排隊播放,並回傳完整的傳輸計數。 然而,若寫入模式為 #WRITE_NON_BLOCKING,或軌道在進入時停止或暫停,或其他執行緒呼叫停止或暫停而中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳短傳輸計數。

在靜態緩衝區模式下,會從偏移量 0 開始將資料複製到緩衝區,寫入模式則被忽略。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(byte[], int, int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

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

偏移後需讀取的短路數。 不得為負值,或導致資料存取超出陣列範圍。

writeMode
WriteMode

其中#WRITE_BLOCKING之一。 #WRITE_NON_BLOCKING 靜態模式下沒有效果。 < >當 ,寫#WRITE_BLOCKING入會阻塞,直到所有資料都寫入音訊匯入。 < >br 當 時#WRITE_NON_BLOCKING,寫入會立即返回,並盡可能排隊播放的音訊資料且不會阻塞。

傳回

零或為正數短路,或以下任一錯誤代碼。 短影片數量將以頻道數的倍數計算,且不超過 sizeInShorts。 <如果軌道沒有正確初始化,則用 li>><>#ERROR_INVALID_OPERATION< li#ERROR_BAD_VALUE>;參數無法解析為有效資料和索引<;如果 AudioTrack 不再有效,需要重新建立,則用 li><li。>#ERROR_DEAD_OBJECT< 如果部分資料成功傳輸,則不會回傳死物件錯誤碼。 在這種情況下,若發生其他錯誤</li<>/ul,錯誤會在下一個 write()</li<>li>#ERROR 回傳>

屬性

備註

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。 AudioTrack 建構器中指定的格式應與 AudioFormat#ENCODING_PCM_16BIT 陣列中的資料相符。

在串流模式下,阻擋行為取決於寫入模式。 若寫入模式為 #WRITE_BLOCKING,寫入通常會阻塞,直到所有資料都排隊播放,並回傳完整的傳輸計數。 然而,若寫入模式為 #WRITE_NON_BLOCKING,或軌道在進入時停止或暫停,或其他執行緒呼叫停止或暫停而中斷寫入,或寫入過程中發生 I/O 錯誤,寫入可能會回傳短傳輸計數。

在靜態緩衝區模式下,會將資料從偏移量0開始複製到緩衝區。 請注意,這些資料的實際播放可能會在此函式回傳後進行。

Java 文件 android.media.AudioTrack.write(short[], int, int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於