本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Raspberry Pi 攝影機
<a name="producersdk-cpp-rpi-camera"></a>

請依照下列步驟設定 [Raspberry Pi 攝影機模組](https://www.raspberrypi.com/documentation/accessories/camera.html)，將影片從裝置傳送至 Kinesis 影片串流。

**注意**  
如果您使用的是 USB 網路攝影機，請跳至 [安裝軟體先決條件](producersdk-cpp-rpi-software.md)。

------
#### [ Camera module 1 ]

請依照這些指示更新模組檔案、啟用相機界面，以及驗證相機的功能。更新模組檔案會告知 Raspberry Pi 在開機時要載入哪些核心模組。預設不會載入攝影機驅動程式，以便在未使用攝影機的 Raspberry Pi 裝置上節省系統資源。

1.  開啟編輯器以變更模組檔案。開啟終端機，並使用下列命令，使用`nano`編輯器編輯檔案：

   ```
   sudo nano /etc/modules
   ```

1. 如果檔案結尾沒有下列內容，請將它加入：

   ```
   bcm2835-v4l2
   ```

1. 儲存檔案，然後退出編輯器。若要使用`nano`編輯器儲存和結束，請使用 Ctrl\+X。

1. 重新啟動 Raspberry Pi：

   ```
   sudo reboot
   ```

1. 裝置重新啟動時，如果您是遠端連接，請透過終端應用程式再次連接。

1. Open `raspi-config`:

   ```
   sudo raspi-config
   ```

1. 選擇**介面選項**、**舊版攝影機**。在 Raspbian 作業系統的較舊版本中，此功能表選項可能位於**介面選項****相機**下。

   如果沒有啟用攝影機則將其啟用，並在出現提示訊息時重新啟動。

1. 輸入下列命令，驗證攝影機是否正常運作：

   ```
   raspistill -v -o test.jpg
   ```

   如果您的攝影機設定正確，此命令會從攝影機擷取影像，將其儲存至名為 的檔案`test.jpg`，並顯示資訊性訊息。

------
#### [ Camera module 2 or 3 ]

如果您使用的是攝影機模組 2，您可以使用 `bcm2835-v4l2`（舊版） 或 `libcamera`（現代）。不過，建議使用 `libcamera`堆疊以獲得更好的支援和功能。請依照下列步驟，確認 在您的系統上`libcamera`是up-to-date。

1. [libcamera](https://www.raspberrypi.com/documentation/computers/camera_software.html#libcamera) 應該預先安裝在 Raspberry Pi 上。檢查是否有任何更新，並更新至最新版本，以取得錯誤修正和安全性更新。開啟終端機並輸入下列命令：

   ```
   sudo apt-get update
   sudo apt-get upgrade
   ```

1. 重新啟動您的系統，讓更新生效。

   ```
   sudo reboot
   ```

1. 測試您的攝影機。此應用程式會啟動攝影機預覽串流，並在螢幕上顯示。

   ```
   libcamera-hello
   ```

   如果相機模組發生問題，請參閱 [Raspberry Pi 文件](https://raspberrypi.com/documentation/computers/camera_software.html#troubleshooting)進行故障診斷。

------