SBCS單板計算機
“
產品資訊
規格：
- 支援的 Raspberry Pi 型號：Pi 0、Pi 1、Pi 2、Pi 3、Pi 4、
CM1、CM3、CM4、CM5、Pico、Pico2 - 音訊輸出選項：HDMI、類比 PCM/3.5 公釐插孔、基於 I2S
轉接板、USB 音訊、藍牙 - 軟體支援：PulseAudio、PipeWire、ALSA
產品使用說明：
HDMI 音頻輸出：
對於 HDMI 音訊輸出，只需將 Raspberry Pi 連接到
內建揚聲器的 HDMI 顯示器或電視。
類比 PCM/3.5 公釐插孔：
Raspberry Pi B+、2、3 和 4 型號配備 4 極 3.5 毫米
用於類比音訊輸出的音訊插孔。請遵循訊號分配
正確連接的表格。
USB音訊和藍牙：
對於 USB 音訊或藍牙輸出，請確保有正確的驅動程式
安裝在你的 Raspberry Pi 上。請參閱使用手冊
詳細的設定說明。
軟件設置：
若要啟用音訊播放，請安裝必要的軟體包
使用命令列。安裝後重新啟動 Raspberry Pi
以使更改生效。
Examp命令：
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils sudo apt install pipewire-alsa pactl list modules short pactl list sinks short
常問問題：
Q：哪些 Raspberry Pi 型號支援模擬音頻
輸出？
答：Raspberry Pi B+、2、3 和 4 型號配備 4 極 3.5 毫米
用於類比音訊輸出的音訊插孔。
Q：我可以在我的 Raspberry Pi 上使用 USB 音效卡嗎？
答：是的，您可以將 USB 音效卡與您的 Raspberry Pi 一起使用，
音頻輸出。確保安裝了正確的驅動程式。
「`
樹莓派
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
樹莓派有限公司
樹莓派有限公司
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
版畫
© 2022-2025 Raspberry Pi Ltd 本文檔採用 Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND) 授權。版本 1.0 建置日期：2025年05月28日
法律免責聲明
不時修改的 RASPBERRY PI 產品（包括資料表）的技術和可靠性資料（「資源」）由 RASPBERRY PI LTD（「RPL」）「按原樣」提供，並提供任何明示或暗示的保證，包括但不限於至，適銷性和特定用途適用性的默示保證不予承擔。在適用法律允許的最大範圍內，在任何情況下，RPL 均不對任何直接、間接、附帶、特殊、懲戒性或後果性損害（包括但不限於購買替代商品或服務；使用、資料遺失）承擔責任。這種可能性此類損害。 RPL 保留隨時對資源或其中所述的任何產品進行任何增強、改進、更正或任何其他修改的權利，恕不另行通知。這些資源適用於具有適當設計知識水準的熟練使用者。使用者對資源的選擇和使用以及其中描述的產品的任何應用承擔全部責任。使用者同意賠償 RPL 並使其免受因使用資源而產生的所有責任、費用、損害或其他損失。 RPL 授予使用者僅將資源與 Raspberry Pi 產品結合使用的權限。禁止將資源用於任何其他用途。未向任何其他 RPL 或其他第三方智慧財產權授予任何許可。高風險活動。 Raspberry Pi 產品並非設計、製造或設計用於需要故障安全性能的危險環境，例如核設施、飛機導航或通訊系統、空中交通管制、武器系統或安全關鍵應用（包括生命維持）的運作系統和其他醫療設備），其中產品故障可能直接導致死亡、人身傷害或嚴重的身體或環境損害（「高風險活動」）。 RPL 特別聲明不對高風險活動的適用性做出任何明示或暗示的保證，也不承擔在高風險活動中使用或包含 Raspberry Pi 產品的任何責任。 Raspberry Pi 產品是依照 RPL 的標準條款提供。 RPL 提供的資源不會擴展或以其他方式修改 RPL 的標準條款，包括但不限於其中表達的免責聲明和保證。
法律免責聲明
2
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
文檔版本歷史
發布日期
描述
1.0
2025 年 4 月 1 日首次發布
文件範圍
本文檔適用於以下樹莓派產品：
圓周率0
圓周率1
圓周率2
皮皮皮皮皮皮 CM1 CM3 CM4 CM5 微微 微微2
3
4 400 5 500
0 WHABABB 全部 全部 全部 全部 全部 全部 全部 全部
文件範圍
1
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
介紹
多年來，Raspberry Pi SBC（單板電腦）上可用的音訊輸出選項日益增多，其軟體驅動方式也發生了變化。本文檔將介紹 Raspberry Pi 裝置上可用的多種音訊輸出選項，並指導您如何在桌面和命令列中使用音訊選項。本白皮書假設 Raspberry Pi 裝置運行的是 Raspberry Pi OS，並且已完全更新至最新韌體和核心。
介紹
2
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
Raspberry Pi 音訊硬體
HDMI
所有 Raspberry Pi SBC 都配備支援 HDMI 音訊的 HDMI 介面。將 Raspberry Pi SBC 連接到帶有揚聲器的顯示器或電視機，即可自動啟用透過這些揚聲器輸出 HDMI 音訊。 HDMI 音訊是一種高品質的數位訊號，因此輸出效果會非常出色，並且支援 DTS 等多聲道音訊。如果您正在使用 HDMI 視頻，但希望音頻訊號分離——例如ample，到一個 amp如果您的音訊轉換器不支援 HDMI 輸入，那麼您將需要使用稱為分離器的額外硬體來從 HDMI 訊號中提取音訊訊號。這可能比較昂貴，但還有其他選擇，如下所述。
類比 PCM/3.5 公釐插孔
Raspberry Pi B+、2、3 和 4 型號配備 4 極 3.5 毫米音訊插孔，可支援音訊和複合視訊訊號。這是由 PCM（脈衝編碼調變）訊號產生的低品質類比輸出，但仍適用於耳機和桌上型揚聲器。
注意：Raspberry Pi 5 上沒有模擬音訊輸出。
下表定義了插頭訊號，從電纜末端開始，到尖端結束。不同的電纜有不同的分配方式，因此請確保您選擇正確的電纜。
插孔段訊號
袖子
影片
環2
地面
環1
正確的
提示
左邊
基於 I2S 的適配器板
所有型號的 Raspberry Pi SBC 均在 GPIO 介面上配備 I2S 週邊。 I2S 是一種電氣串列匯流排介面標準，用於連接數位音訊設備並在電子設備的周邊之間傳輸 PCM 音訊資料。 Raspberry Pi Ltd 生產一系列音訊板，這些音訊板可連接到 GPIO 接口，並使用 I2S 介面將音訊資料從 SoC（系統單晶片）傳輸到擴充板。注意：透過 GPIO 介面連接並符合對應規範的擴充板稱為 HAT（頂部附加硬體）。它們的規格可在此處找到：https://datasheets.raspberrypi.com/。您可以在 Raspberry Pi Ltd 網站上查看所有音訊 HAT。 web網址：https://www.raspberrypi.com/products/ 還有大量第三方 HAT 可用於音訊輸出，例如amp來自 Pimoroni、HiFiBerry、Adafruit 等，它們提供了多種不同的功能。
USB音訊
如果您無法安裝 HAT，或者正在尋找一種快速簡便的方法來連接耳機輸出或麥克風輸入的插孔，那麼 USB 音訊轉接器是一個不錯的選擇。這些裝置簡單、便宜，可以插入 Raspberry Pi SBC 上的一個 USB-A 連接埠。 Raspberry Pi OS 預設包含 USB 音訊驅動程式；裝置插入後，它會顯示在右鍵點擊工作列上的揚聲器圖示時出現的裝置選單中。系統也會自動偵測所連接的 USB 裝置是否支援麥克風輸入，並啟用對應的支援。
USB音訊
3
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
藍牙
藍牙音訊是指透過藍牙技術無線傳輸聲音數據，此技術應用非常廣泛。它使 Raspberry Pi SBC 能夠與藍牙揚聲器、耳機/耳塞或任何其他支援藍牙的音訊裝置通訊。藍牙連接範圍相對較短，最大約 10 公尺。藍牙裝置需要與 Raspberry Pi SBC“配對”，配對完成後，藍牙裝置將顯示在桌面的音訊設定中。 Raspberry Pi OS 預設安裝藍牙，任何安裝了藍牙硬體（內建或透過藍牙 USB 轉接器安裝）的裝置都會在桌面工作列上顯示藍牙標誌。啟用藍牙後，圖示顯示為藍色；停用藍牙後，圖示顯示為灰色。
藍牙
4
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
軟體支援
在完整的 Raspberry Pi OS 鏡像中，底層音訊支援軟體發生了很大變化，而對於最終用戶來說，這些變化大多是透明的。最初使用的聲音子系統是 ALSA。 PulseAudio 繼承了 ALSA，後來被目前的系統 PipeWire 取代。該系統具有與 PulseAudio 相同的功能和相容的 API，但它還具有處理視訊和其他功能的擴展，使視訊和音訊的整合更加容易。由於 PipeWire 使用與 PulseAudio 相同的 API，因此 PulseAudio 實用程式在 PipeWire 系統上可以正常運作。這些實用程式在amp請參閱下面的文件。為了減小鏡像大小，Raspberry Pi OS Lite 仍然使用 ALSA 提供音訊支持，並且不包含任何 PipeWire、PulseAudio 或藍牙音訊庫。但是，您可以根據需要安裝相應的庫來添加這些功能，此過程也在下面描述。
桌面
如上所述，音訊操作是透過桌面工作列上的揚聲器圖示進行的。左鍵點選該圖示會調出音量滑桿和靜音按鈕，右鍵點選則會調出可用音訊裝置清單。只需點擊要使用的音訊設備即可。右鍵單擊也可以選擇更改音訊設備。file每個設備使用的。這些專業file通常提供不同的品質等級。如果啟用了麥克風支持，選單上會出現麥克風圖示；右鍵單擊該圖示將顯示麥克風特定的選單選項，例如輸入裝置選擇，而左鍵單擊將顯示輸入等級設定。藍牙要配對藍牙設備，請左鍵點選工作列上的藍牙圖標，然後選擇「新增設備」。然後系統將開始尋找可用的設備，需要將這些設備置於「發現」模式才能看到。當設備出現在清單中時單擊它，然後設備應該配對。配對後，音訊設備將出現在選單中，可透過點選工作列上的揚聲器圖示來選擇。
命令列
由於 PipeWire 使用與 PulseAudio 相同的 API，因此用於控制音訊的大多數 PulseAudio 命令都可以在 PipeWire 上運行。 pactl 是控制 PulseAudio 的標準方法：在命令列中輸入 man pactl 以了解更多詳細資訊。 Raspberry Pi OS Lite 的先決條件：在完整安裝的 Raspberry Pi OS 中，所有必要的命令列應用程式和程式庫都已安裝。然而，在 Lite 版本中，PipeWire 預設為未安裝，必須手動安裝才能播放聲音。若要在 Raspberry Pi OS Lite 上安裝 PipeWire 所需的程式庫，請輸入以下內容：
sudo apt 安裝 pipewire pipewire-pulse pipewire-audio pulseaudio-utils
如果您打算執行使用 ALSA 的應用程序，您還需要安裝以下內容：
sudo apt 安裝 pipewire-alsa
安裝後重新啟動是讓一切正常運作最簡單的方法。音訊播放範例amples 以簡短形式顯示已安裝的 PulseAudio 模組清單（長格式包含大量訊息，難以閱讀）：
$ pactl 列出簡短的模組
以簡短形式顯示 PulseAudio 接收器清單：
命令列
5
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
$ pactl 清單短
在連接到具有內建音訊和附加 USB 音效卡的 HDMI 顯示器的 Raspberry Pi 5 上，此指令提供以下輸出：
$ pactl list sinks short 179 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz SUSPENDED 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output PipeWire s16le 2ch 48000Hz SUSPENDED
注意：Raspberry Pi 5 沒有類比輸出。在 Raspberry Pi 4（具有 HDMI 和類比輸出）上安裝 Raspberry Pi OS Lite 後，將返回以下內容：
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2ch 48000Hz SUSPENDED 70 alsa_output.platform-107c701400.mimi88 SUSPENDED
要在此 Raspberry Pi OS Lite 安裝中顯示並將預設接收器變更為 HDMI 音訊（請注意，它可能已經是預設值），請輸入：
$ pactl 取得預設接收器 alsa_output.platform-bcm2835_audio.立體聲-fallback $ pactl 設定預設接收器 70 $ pactl 取得預設接收器 alsa_output.platform-107c701400.hdmi.hdmi-立體聲
播放ample，首先需要將其上傳到ample 緩存，在本例中是預設接收器。您可以透過將其名稱新增至 pactl play-s 的末端來變更接收器。amp勒命令：
$ pactl upload-sampsample.mp3 samp檔名 $ pactl play-sampsamp檔案名稱
有一個 PulseAudio 命令可以更輕鬆地播放音訊：
$ paplay samp樂.mp3
pactl 有一個選項可以設定播放音量。由於桌面使用 PulseAudio 實用程式來獲取和設定音訊訊息，因此這些命令列變更的執行也會反映在桌面上的音量滑桿上。例如ample 將音量降低 10%：
$ pactl 設定接收器體積 @DEFAULT_SINK@ -10%
這個前任ample 將音量設定為 50%：
$ pactl 設定接收器體積 @DEFAULT_SINK@ 50%
這裡沒有提到很多 PulseAudio 指令。 PulseAudio web網站（https://www.freedesktop.org/wiki/Software/PulseAudio/）和每個命令的手冊頁面提供了有關係統的大量資訊。
命令列
6
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
藍牙 從命令列控制藍牙可能是一個複雜的過程。使用 Raspberry Pi OS Lite 時，對應的指令已經安裝好了。最有用的指令是 bluetoothctl，還有一些其他指令amp下面提供了正在使用中的設備資訊。使設備可被其他設備發現：
$ bluetoothctl 可發現
使設備與其他設備配對：
$ bluetoothctl 可配對
掃描範圍內的藍牙裝置：
$ bluetoothctl 掃描
關閉掃描：
$ bluetoothctl 掃描關閉
bluetoothctl 也有一個互動模式，可以透過不帶參數的指令來呼叫。例如ample 在執行 Raspberry Pi OS Lite Bookworm 的 Raspberry Pi 4 上執行互動模式，輸入清單指令並顯示結果：
$ bluetoothctl 代理程式已註冊 [藍牙]# 清單控制器 D8:3A:DD:3B:00:00 Pi4Lite [預設] [藍牙]#
現在，您可以在解釋器中輸入命令，它們將被執行。與設備配對並連接的典型流程如下：
$ bluetoothctl 代理程式已註冊 [藍牙]# 可發現 更改可發現狀態成功 [CHG] 控制器 D8:3A:DD:3B:00:00 可發現 [藍牙]# 可配對 更改可配對狀態成功 [CHG] 控制器 D8:3A:DD:3B:00:00 可配對狀態成功 [CHG] 控制器 D8:3A:DD:3B:00:00 可配對狀態。
< 可能是附近設備的一長串清單 >
[藍牙]# pair [裝置的 mac 位址，來自掃描指令或來自裝置本身，格式為 xx:xx:xx:xx:xx:xx] [藍牙]# scan off [藍牙]# connect [相同的 mac 位址] 藍牙裝置現在應該出現在接收器清單中，如下例所示amp來自 Raspberry Pi OS Lite 安裝的檔案：
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2ch 48000Hz SUSPENDED 70 alsa_output.platform-107c701400.mimi88 SUSPENDED 71 bluez_output.CA_3A_B2_CA_7C_55.1 PipeWire s32le 2ch 48000Hz SUSPENDED
命令列
7
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
$ pactl 設定預設接收器 71 $ paplayample_audio_file>
現在您可以將其設為預設並在其上播放音訊。
命令列
8
一份白皮書給予高層領導view Raspberry Pi SBC 上的音訊選項
結論
Raspberry Pi Ltd 裝置有多種不同的音訊輸出方式，可滿足絕大多數使用者的需求。本白皮書概述了這些機制，並提供了其中許多機制的相關資訊。希望本文提供的建議能幫助最終用戶為其專案選擇合適的音訊輸出方案。簡單範例amp已經提供如何使用音訊系統的文件，但讀者應該查閱音訊和藍牙命令的手冊和手冊頁以了解更多詳細資訊。
結論
9
Raspberry Pi 白皮書提供高水準的view Raspberry Pi SBC 上的音訊選項
樹莓派
Raspberry Pi 是 Raspberry Pi Ltd 的商標
樹莓派有限公司
文件/資源
 |
Raspberry Pi SBCS 單板計算機 [pdf] 使用者指南 SBCS 單板計算機，SBCS，單板計算機，闆卡計算機，計算機 |