相機(jī)組件支持相機(jī)業(yè)務(wù)的開(kāi)發(fā)，開(kāi)發(fā)者可以通過(guò)已開(kāi)放的接口實(shí)現(xiàn)相機(jī)硬件的訪問(wèn)、操作和新功能開(kāi)發(fā)，最常見(jiàn)的操作如：預(yù)覽、拍照和錄像等。

基本概念

• 拍照
  此功能用于拍攝采集照片。
• 預(yù)覽
  此功能用于在開(kāi)啟相機(jī)后，在緩沖區(qū)內(nèi)重復(fù)采集攝像幀，支持在拍照或錄像前進(jìn)行攝像幀預(yù)覽顯示。
• 錄像
  此功能用于在開(kāi)始錄像后和結(jié)束錄像前的時(shí)間段內(nèi)，在緩沖區(qū)內(nèi)重復(fù)采集攝像幀，支持視頻錄制。

圖 1 相機(jī)組件架構(gòu)圖

目錄

倉(cāng)目錄結(jié)構(gòu)如下：

/foundation/multimedia/camera_framework   # 相機(jī)組件業(yè)務(wù)代碼
├── frameworks                           # 框架代碼
│   ├── native                           # 內(nèi)部接口實(shí)現(xiàn)
│   │   ├── camera                       # 相機(jī)框架實(shí)現(xiàn)
│   │   └── metadata                     # 元數(shù)據(jù)實(shí)現(xiàn)
│   └── js                               # 外部接口實(shí)現(xiàn)
│       └── camera_napi                  # 相機(jī)NAPI實(shí)現(xiàn)
├── interfaces                           # 接口代碼
│   ├── inner_api                        # 內(nèi)部接口
│   └── kits                             # 外部接口
├── LICENSE                              # 許可證文件
├── ohos.build                           # 構(gòu)建文件
├── sa_profile                           # 服務(wù)配置文件
└── services                             # 服務(wù)代碼
    ├── camera_service                   # 相機(jī)服務(wù)實(shí)現(xiàn)
    └── etc                              # 相機(jī)服務(wù)配置

使用說(shuō)明

拍照

拍照的步驟:

1. 創(chuàng)建緩沖區(qū)消費(fèi)者端監(jiān)聽(tīng)器（CaptureSurfaceListener）以保存圖像。

   class CaptureSurfaceListener : public IBufferConsumerListener {
   public:
       int32_t mode_;
       sptr< Surface > surface_;
   
       void OnBufferAvailable() override
       {
           int32_t flushFence = 0;
           int64_t timestamp = 0;
           OHOS::Rect damage; // initialize the damage
   
           OHOS::sptr< OHOS::SurfaceBuffer > buffer = nullptr;
           surface_- >AcquireBuffer(buffer, flushFence, timestamp, damage);
           if (buffer != nullptr) {
               void* addr = buffer- >GetVirAddr();
               int32_t size = buffer- >GetSize();
   
               // Save the buffer(addr) to a file.
   
               surface_- >ReleaseBuffer(buffer, -1);
           }
       }
   };
   

2. 獲取相機(jī)管理器實(shí)例并獲取相機(jī)對(duì)象列表。

   sptr< CameraManager > camManagerObj = CameraManager::GetInstance();
   std::vector< sptr< CameraInfo >> cameraObjList = camManagerObj- >GetCameras();
   

3. 使用相機(jī)對(duì)象創(chuàng)建相機(jī)輸入來(lái)打開(kāi)相機(jī)。

   sptr< CaptureInput > cameraInput = camManagerObj- >CreateCameraInput(cameraObjList[0]);
   

4. 創(chuàng)建采集會(huì)話。

   sptr< CaptureSession > captureSession = camManagerObj- >CreateCaptureSession();
   

5. 開(kāi)始配置采集會(huì)話。

   int32_t result = captureSession- >BeginConfig();
   

6. 將相機(jī)輸入添加到采集會(huì)話。

   result = captureSession- >AddInput(cameraInput);
   

7. 創(chuàng)建消費(fèi)者 Surface 并注冊(cè)監(jiān)聽(tīng)器以監(jiān)聽(tīng)緩沖區(qū)更新。拍照的寬和高可以配置為所支持的 1280x960 分辨率。

   sptr< Surface > photoSurface = Surface::CreateSurfaceAsConsumer();
   int32_t photoWidth = 1280;
   int32_t photoHeight = 960;
   photoSurface- >SetDefaultWidthAndHeight(photoWidth, photoHeight);
   photoSurface- >SetUserData(CameraManager::surfaceFormat, std::to_string(OHOS_CAMERA_FORMAT_JPEG));
   sptr< CaptureSurfaceListener > capturelistener = new(std::nothrow) CaptureSurfaceListener();
   capturelistener- >mode_ = MODE_PHOTO;
   capturelistener- >surface_ = photoSurface;
   photoSurface- >RegisterConsumerListener((sptr< IBufferConsumerListener > &)capturelistener);
   

8. 使用上面創(chuàng)建的 Surface 創(chuàng)建拍照輸出。

   sptr< CaptureOutput > photoOutput = camManagerObj- >CreatePhotoOutput(photoSurface);
   

9. 將拍照輸出添加到采集會(huì)話。

   result = captureSession- >AddOutput(photoOutput);
   

10. 將配置提交到采集會(huì)話。

result = captureSession- >CommitConfig();

11. 拍攝照片。

result = ((sptr PhotoOutput > &)photoOutput)- >Capture();

12. 釋放采集會(huì)話資源。

captureSession- >Release();

13. 釋放相機(jī)輸入關(guān)閉相機(jī)。

cameraInput- >Release();

開(kāi)始和停止預(yù)覽

開(kāi)始和停止預(yù)覽的步驟:

1. 獲取相機(jī)管理器實(shí)例并獲取相機(jī)對(duì)象列表。

   sptr< CameraManager > camManagerObj = CameraManager::GetInstance();
   std::vector< sptr< CameraInfo >> cameraObjList = camManagerObj- >GetCameras();
   

2. 使用相機(jī)對(duì)象創(chuàng)建相機(jī)輸入來(lái)打開(kāi)相機(jī)。

   sptr< CaptureInput > cameraInput = camManagerObj- >CreateCameraInput(cameraObjList[0]);
   

3. 創(chuàng)建采集會(huì)話。

   sptr< CaptureSession > captureSession = camManagerObj- >CreateCaptureSession();
   

4. 開(kāi)始配置采集會(huì)話。

   int32_t result = captureSession- >BeginConfig();
   

5. 將相機(jī)輸入添加到采集會(huì)話。

   result = captureSession- >AddInput(cameraInput);
   

6. 使用從窗口管理器獲得的 Surface 創(chuàng)建預(yù)覽輸出用以在顯示上渲染。預(yù)覽的寬和高可以配置為所支持的 640x480 或 832x480 分辨率，如果想保存到文件，可以按照拍照流程提到步驟，創(chuàng)建 Surface，注冊(cè)監(jiān)聽(tīng)器以監(jiān)聽(tīng)緩沖區(qū)更新。

   int32_t previewWidth = 640;
   int32_t previewHeight = 480;
   previewSurface- >SetUserData(CameraManager::surfaceFormat, std::to_string(OHOS_CAMERA_FORMAT_YCRCB_420_SP));
   sptr< CaptureOutput > previewOutput = camManagerObj- >CreateCustomPreviewOutput(previewSurface, previewWidth, previewHeight);
   

7. 將預(yù)覽輸出添加到采集會(huì)話。

   result = captureSession- >AddOutput(previewOutput);
   

8. 將配置提交到采集會(huì)話。

   result = captureSession- >CommitConfig();
   

9. 開(kāi)始預(yù)覽。

   result = captureSession- >Start();
   

10. 需要時(shí)停止預(yù)覽。

result = captureSession- >Stop();

11. 釋放采集會(huì)話資源。

captureSession- >Release();

12. 釋放相機(jī)輸入關(guān)閉相機(jī)。

cameraInput- >Release();

視頻錄像

視頻錄像的步驟:

1. 獲取相機(jī)管理器實(shí)例并獲取相機(jī)對(duì)象列表。

   sptr< CameraManager > camManagerObj = CameraManager::GetInstance();
   std::vector< sptr< CameraInfo >> cameraObjList = camManagerObj- >GetCameras();
   

2. 使用相機(jī)對(duì)象創(chuàng)建相機(jī)輸入來(lái)打開(kāi)相機(jī)。

   sptr< CaptureInput > cameraInput = camManagerObj- >CreateCameraInput(cameraObjList[0]);
   

3. 創(chuàng)建采集會(huì)話。

   sptr< CaptureSession > captureSession = camManagerObj- >CreateCaptureSession();
   

4. 開(kāi)始配置采集會(huì)話。

   int32_t result = captureSession- >BeginConfig();
   

5. 將相機(jī)輸入添加到采集會(huì)話。

   result = captureSession- >AddInput(cameraInput);
   

6. 通過(guò) Surface 創(chuàng)建一個(gè)視頻輸出，來(lái)與音頻合成并保存到文件，Surface 通過(guò) Recoder 獲取。如果想僅保存視頻緩沖數(shù)據(jù)到文件里，可以按照拍照流程提到步驟，創(chuàng)建 Surface，注冊(cè)監(jiān)聽(tīng)器以監(jiān)聽(tīng)緩沖區(qū)更新。錄像的分辨率可以在錄制器內(nèi)配置為所支持的 1280x720 或 640x360 分辨率。

   videoSurface- >SetUserData(CameraManager::surfaceFormat, std::to_string(OHOS_CAMERA_FORMAT_YCRCB_420_SP));
   sptr< CaptureOutput > videoOutput = camManagerObj- >CreateVideoOutput(videoSurface);
   

7. 將視頻輸出添加到采集會(huì)話。

   result = captureSession- >AddOutput(videoOutput);
   

8. 將配置提交到采集會(huì)話。

   result = captureSession- >CommitConfig();
   

9. 開(kāi)始視頻錄制。

   result = ((sptr VideoOutput > &)videoOutput)- >Start();
   

10. 需要時(shí)停止錄制。

result = ((sptr VideoOutput > &)videoOutput)- >Stop();

11. 釋放采集會(huì)話的資源。

captureSession- >Release();

12. 釋放相機(jī)輸入關(guān)閉相機(jī)。

cameraInput- >Release();

切換多個(gè)照相機(jī)設(shè)備

以下演示如何切換多個(gè)照相機(jī)設(shè)備。最初在采集會(huì)話中有一個(gè)視頻輸出（video output）。如果用戶想要切換其他 照相機(jī)，現(xiàn)存的相機(jī)輸入和輸出需要先移除并加入新的相機(jī)輸入和輸出（示例中使用的是photo output）。

1. 獲取相機(jī)管理器實(shí)例并獲取相機(jī)對(duì)象列表。

   sptr< CameraManager > camManagerObj = CameraManager::GetInstance();
   std::vector< sptr< CameraInfo >> cameraObjList = camManagerObj- >GetCameras();
   

2. 使用相機(jī)對(duì)象創(chuàng)建相機(jī)輸入來(lái)打開(kāi)相機(jī)。

   sptr< CaptureInput > cameraInput = camManagerObj- >CreateCameraInput(cameraObjList[0]);
   

3. 創(chuàng)建采集會(huì)話。

   sptr< CaptureSession > captureSession = camManagerObj- >CreateCaptureSession();
   

4. 開(kāi)始配置采集會(huì)話。

   int32_t result = captureSession- >BeginConfig()
   

5. 將相機(jī)輸入添加到采集會(huì)話。

   result = captureSession- >AddInput(cameraInput);
   

6. 通過(guò)Surface創(chuàng)建一個(gè)視頻輸出。

   sptr< CaptureOutput > videoOutput = camManagerObj- >CreateVideoOutput(videoSurface);
   

7. 將視頻輸出添加到采集會(huì)話。

   result = captureSession- >AddOutput(videoOutput);
   

8. 將配置提交到采集會(huì)話。

   result = captureSession- >CommitConfig();
   

9. 開(kāi)始錄制視頻。

   result = ((sptr VideoOutput > &)videoOutput)- >Start();
   

10. 需要時(shí)停止錄制。

result = ((sptr VideoOutput > &)videoOutput)- >Stop();

11. 重新配置會(huì)話并移除相機(jī)輸入和輸出。

int32_t result = captureSession- >BeginConfig();

12. 在新的會(huì)話配置中移除相機(jī)輸入。

int32_t result = captureSession- >RemoveInput(cameraInput);

13. 同樣移除相機(jī)輸出。

int32_t result = captureSession- >RemoveOutut(videoOutput);

14. 創(chuàng)建新的相機(jī)輸入，并把它添加到采集會(huì)話。

sptr< CaptureInput > cameraInput2 = camManagerObj- >CreateCameraInput(cameraObjList[1]);
result = captureSession- >AddInput(cameraInput2);

15. 創(chuàng)建拍照輸出，成功創(chuàng)建后將拍照輸出添加到采集會(huì)話。創(chuàng)建消費(fèi)者 Surface 并注冊(cè)監(jiān)聽(tīng)器以監(jiān)聽(tīng)新的拍照輸出緩沖區(qū)更新。這個(gè) Surface 用于新創(chuàng)建的拍照輸出。

// Get the surface
sptr< Surface > photoSurface = Surface::CreateSurfaceAsConsumer();
int32_t photoWidth = 1280;
int32_t photoHeight = 960;
photoSurface- >SetDefaultWidthAndHeight(photoWidth, photoHeight);
photoSurface- >SetUserData(CameraManager::surfaceFormat, std::to_string(OHOS_CAMERA_FORMAT_JPEG));
sptr< CaptureSurfaceListener > capturelistener = new(std::nothrow) CaptureSurfaceListener();
capturelistener- >mode_ = MODE_PHOTO;
capturelistener- >surface_ = photoSurface;
photoSurface- >RegisterConsumerListener((sptr< IBufferConsumerListener > &)capturelistener);

// Create the Photo Output
sptr< CaptureOutput > photoOutput = camManagerObj- >CreatePhotoOutput(photoSurface);

// Add the output to the capture session
result = captureSession- >AddOutput(photoOutput);

16. 將配置提交到采集會(huì)話。

result = captureSession- >CommitConfig();

17. 釋放被移出會(huì)話的相機(jī)輸入。

cameraInput- >Release();

18. 拍攝照片。

result = ((sptr PhotoOutput > &)photoOutput)- >Capture();

19. 釋放采集會(huì)話資源。

captureSession- >Release();

20. 釋放相機(jī)輸入關(guān)閉相機(jī)。

cameraInput2- >Release();

設(shè)置閃光燈

拍照和錄像前可以在相機(jī)輸入里設(shè)置閃光燈。

1. 在照相中設(shè)置閃光燈。

   cameraInput- >LockForControl();
   cameraInput- >SetFlashMode(OHOS_CAMERA_FLASH_MODE_OPEN);
   cameraInput- >UnlockForControl();
   

2. 在錄像中設(shè)置閃光燈。

   cameraInput- >LockForControl();
   cameraInput- >SetFlashMode(OHOS_CAMERA_FLASH_MODE_ALWAYS_OPEN);
   cameraInput- >UnlockForControl();
   

3. 關(guān)閉閃光燈。

   cameraInput- >LockForControl();
   cameraInput- >SetFlashMode(OHOS_CAMERA_FLASH_MODE_CLOSE);
   cameraInput- >UnlockForControl();
   

   鴻蒙OpenHarmony知識(shí)已更新←前往