# MultiMedia\_CameraKit - [Overview](#section2120628768165625) - [Summary](#section2055549443165625) - [Files](#files) - [Data Structures](#nested-classes) - [Functions](#func-members) - [Details](#section1483794495165625) - [Function](#section1531552527165625) - [CreateCamera\(\)](#gaa21f4e248e3a46a4f78f4261cba82fe2) - [GetCameraAbility\(\)](#gab4cfb051de29415d080a203ca4639448) - [GetCameraIds\(\)](#ga8894d876198f2614d65b432a8a002163) - [GetInstance\(\)](#ga1911ba8eca0e57ddc15df25cf2b21f7b) - [RegisterCameraDeviceCallback\(\)](#ga4e6cd8787f06c4a82ad982d36029b3ec) - [UnregisterCameraDeviceCallback\(\)](#ga4f0117575ee988f6d74a3636e01f0aba) - [\~CameraKit\(\)](#ga7d36867ec1bd57e25d1c60b5de24cbe6) ## **Overview** **Description:** Defines the **CameraKit** class for using camera functionalities. **Since:** 1.0 **Version:** 1.0 ## **Summary** ## Files

File Name

Description

camera_kit.h

Declares functions in the CameraKit class.

## Data Structures

Data Structure Name

Description

OHOS::Media::CameraKit

Provides functions in the CameraKit class.

## Functions

Function

Description

OHOS::Media::CameraKit::~CameraKit ()

A destructor used to delete the CameraKit instance.

OHOS::Media::CameraKit::GetInstance ()

static CameraKit *

Obtains a single instance of the CameraKit.

OHOS::Media::CameraKit::GetCameraIds ()

std::list< std::string >

Obtains IDs of cameras that are currently available.

OHOS::Media::CameraKit::GetCameraAbility (std::string cameraId)

const CameraAbility *

Obtains the camera capability, including the resolutions and frame rates.

OHOS::Media::CameraKit::RegisterCameraDeviceCallback (CameraDeviceCallback &callback, EventHandler &handler)

void

Registers a camera callback for camera status changes and an event callback to respond to a triggered event.

OHOS::Media::CameraKit::UnregisterCameraDeviceCallback (CameraDeviceCallback &callback)

void

Unregisters a camera callback.

OHOS::Media::CameraKit::CreateCamera (const std::string &cameraId, CameraStateCallback &callback, EventHandler &handler)

void

Creates a camera object.

## **Details** ## **Function ** ## CreateCamera\(\) ``` void OHOS::Media::CameraKit::CreateCamera (const std::string & cameraId, [CameraStateCallback](OHOS-Media-CameraStateCallback.md) & callback, EventHandler & handler ) ``` **Description:** Creates a camera object. **Parameters:**

Name

Description
cameraId Indicates the camera ID.
callback Indicates the camera callback.
handler Indicates the event callback to register.
## GetCameraAbility\(\) ``` const [CameraAbility](OHOS-Media-CameraAbility.md)* OHOS::Media::CameraKit::GetCameraAbility (std::string cameraId) ``` **Description:** Obtains the camera capability, including the resolutions and frame rates. **Parameters:**

Name

Description
cameraId Indicates the camera ID.
**Returns:** Returns the **[CameraAbility](OHOS-Media-CameraAbility.md)** object. ## GetCameraIds\(\) ``` std::list OHOS::Media::CameraKit::GetCameraIds () ``` **Description:** Obtains IDs of cameras that are currently available. **Returns:** Returns the camera IDs if obtained; returns **NULL** otherwise. ## GetInstance\(\) ``` static [CameraKit](OHOS-Media-CameraKit.md)* OHOS::Media::CameraKit::GetInstance () ``` **Description:** Obtains a single instance of the **[CameraKit](OHOS-Media-CameraKit.md)**. **Returns:** Returns the **[CameraKit](OHOS-Media-CameraKit.md)** instance if obtained; returns **NULL** otherwise. ## RegisterCameraDeviceCallback\(\) ``` void OHOS::Media::CameraKit::RegisterCameraDeviceCallback ([CameraDeviceCallback](OHOS-Media-CameraDeviceCallback.md) & callback, EventHandler & handler ) ``` **Description:** Registers a camera callback for camera status changes and an event callback to respond to a triggered event. **Parameters:**

Name

Description
callback Indicates the camera callback to register.
handler Indicates the event callback to register.
## UnregisterCameraDeviceCallback\(\) ``` void OHOS::Media::CameraKit::UnregisterCameraDeviceCallback ([CameraDeviceCallback](OHOS-Media-CameraDeviceCallback.md) & callback) ``` **Description:** Unregisters a camera callback. **Parameters:**

Name

Description
callback Indicates the camera callback to unregister.
## \~CameraKit\(\) ``` OHOS::Media::CameraKit::~CameraKit () ``` **Description:** A destructor used to delete the **[CameraKit](OHOS-Media-CameraKit.md)** instance.