fuchsia.audio.impact

1

這個輸入串流的格式。必填。

2

這個輸入串流的緩衝區。必須提供寫入存取權，並為 ProcessorConfiguration.max_frames_per_call 提供足夠的空間。

必填。

1

此輸出串流的格式。必填。

2

這個輸出串流的緩衝區。必須提供寫入存取權，並為 ProcessorConfiguration.max_frames_per_call 提供足夠的空間。系統需要寫入存取權，才能在發生錯誤 (例如處理器中斷連線) 時，將音訊系統寫入輸出緩衝區。

如果效果支援就地更新，這可能會參照與輸入緩衝區相同的記憶體範圍。

必填。

3

如有指定，輸出信號就會隨著這個影格移動。如未指定，則這個值為零。請前往 [fuchsia.audio.effects/Processor.Process] 查看說明。

4

如果指定，輸入影格 F 就會影響到畫面 F + ring_out_frames 的輸出串流。如未指定，則值為 0。

說得不一，如果效果給具有 N 個非靜音影格的輸入串流，接著是無限靜音，則在發出靜音前，效果最多將產生 N + ring_out_frames 個非靜音影格。

1

每個處理程序呼叫都可以 (選擇性) 分成多個階段，每個階段都有專屬的 ProcessMetrics。這個欄位會命名此表格所描述的階段。

2

從收到 Process 呼叫開始，到傳回回應為止的總時鐘時間。

3

在 CPU 上執行的總時間。請參閱 zx_info_task_runtime.cpu_time。

4

等待執行的總時間。只會計算「就緒」時間。請參閱 zx_info_task_runtime.queue_time。

5

處理頁面錯誤所花費的時間總計。請參閱 zx_info_task_runtime.page_fault_time。

6

等待事件核心鎖定的等待時間總計。請參閱 zx_info_task_runtime.lock_contention_time。

1

透過先前的處理步驟套用至每個輸入串流的總效益。以表單輸入 -> ProcessorA -> ProcessorB 的形式，如果輸入內容是振幅有單位的正弦波，ProcessorA 會套用 -5.0dB 的增益，則處理 ProcessorB 時應使用 total_wave_gain_db_per_input[0] = -5.0dB's 和 buffers.0]，並含有 -5.0dB 這個緩衝區。

如未指定，則每個輸入的應用收益會是 0 dB。

2

提供給每個輸入串流的所有 fuchsia.media.AudioRenderUsage。這個位元遮罩各為 (1 << r)，對於所有有貢獻的 AudioRenderUsage。舉例來說，如果輸入串流包含 BACKGROUND (== 0) 和 INTERRUPTION (== 2)，位元遮罩為 ((1<<0)|(1<<2))) = 0x5。

注意：在我們轉換至新的 Fuuchsia 媒體 API 後，可能會移除這個欄位。

1

這個處理器的專屬 FIDL 管道。 必填。

2

這個處理器的所有輸入串流說明。至少須輸入一個值。

每個輸入串流可以有不同的取樣格式或管道數，但所有輸入的影格速率都必須相同。

3

這個處理器的所有輸出串流說明。至少須有一個輸出內容。

每個輸出串流可能會有不同的取樣格式或管道數量，但所有輸出的影格速率都必須與輸入相同。只要畫面更新率保持不變，效果就可以執行範例格式轉換和重新分次作業。

4

每次呼叫 fuchsia.audio.effects/Processor.Process 時，可處理的影格數量上限。預設限制是最小輸入緩衝區能容納的影格數量。指定時，這個值必須小於預設上限。

5

如果有指定，所有對 fuchsia.audio.effects/Processor.Process 的呼叫。都必須將 num_frames 設為此數字的倍數。必須小於或等於 max_frames_per_call。如未指定，則允許使用任何區塊大小。

1

2

1

2

輸入和輸出串流的數量上限。這些邊界可以任意決定；實際上，在絕大多數情況下，我們並預期不會超過 1 或 2 個輸入和輸出。

per_stage_metrics 陣列的大小上限。

程序階段名稱的長度上限。