AudioTrack.Write 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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 所創建與分享的作品,並依授權條款所描述的使用進行修改。