# MultiMedia\_CameraAbility<a name="ZH-CN_TOPIC_0000001054479517"></a>

-   [Overview](#section59896362165625)
-   [Summary](#section1342120614165625)
-   [Files](#files)
-   [Data Structures](#nested-classes)
-   [Functions](#func-members)
-   [Details](#section1351292470165625)
-   [Function](#section23304000165625)
-   [CameraAbility\(\)](#ga7f1b94b32f7c7b121ea14b3147788497)
-   [GetParameterRange\(\)](#ga3fb9142cc5bbeafef3201ecaaf50c737)
-   [GetSupportedSizes\(\)](#ga840850d531b96cc5a829b257ade3c7e6)
-   [SetParameterRange\(\)](#ga23410306b850fe7edcb736f50fe8048d)
-   [\~CameraAbility\(\)](#ga797435bcd10278e33fb7b6f4951f0d7f)

## **Overview**<a name="section59896362165625"></a>

**Description:**

Defines the camera capability set for applications to achieve and access the capabilities. 

**Since:**

1.0

**Version:**

1.0

## **Summary**<a name="section1342120614165625"></a>

## Files<a name="files"></a>

<a name="table2070050393165625"></a>
<table><thead align="left"><tr id="row6391294165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p1009479859165625"><a name="p1009479859165625"></a><a name="p1009479859165625"></a>File Name</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p78425149165625"><a name="p78425149165625"></a><a name="p78425149165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row2118012632165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1407978261165625"><a name="p1407978261165625"></a><a name="p1407978261165625"></a><a href="camera_ability-h.md">camera_ability.h</a></p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1287626289165625"><a name="p1287626289165625"></a><a name="p1287626289165625"></a>Declares functions of the <strong id="b1721319501165625"><a name="b1721319501165625"></a><a name="b1721319501165625"></a>CameraAbility</strong> class. </p>
</td>
</tr>
</tbody>
</table>

## Data Structures<a name="nested-classes"></a>

<a name="table532966494165625"></a>
<table><thead align="left"><tr id="row616512864165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p138599350165625"><a name="p138599350165625"></a><a name="p138599350165625"></a>Data Structure Name</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p435809614165625"><a name="p435809614165625"></a><a name="p435809614165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row294938108165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p12265009165625"><a name="p12265009165625"></a><a name="p12265009165625"></a><a href="OHOS-Media-CameraAbility.md">OHOS::Media::CameraAbility</a></p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p523213496165625"><a name="p523213496165625"></a><a name="p523213496165625"></a>Declares functions of the <strong id="b1679199873165625"><a name="b1679199873165625"></a><a name="b1679199873165625"></a><a href="OHOS-Media-CameraAbility.md">CameraAbility</a></strong> class. </p>
</td>
</tr>
</tbody>
</table>

## Functions<a name="func-members"></a>

<a name="table1196922009165625"></a>
<table><thead align="left"><tr id="row1340161621165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p1719082145165625"><a name="p1719082145165625"></a><a name="p1719082145165625"></a>Function</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p1186694806165625"><a name="p1186694806165625"></a><a name="p1186694806165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row1921635347165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1217193645165625"><a name="p1217193645165625"></a><a name="p1217193645165625"></a><a href="MultiMedia_CameraAbility.md#ga7f1b94b32f7c7b121ea14b3147788497">OHOS::Media::CameraAbility::CameraAbility</a> ()</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1503938242165625"><a name="p1503938242165625"></a><a name="p1503938242165625"></a> </p>
<p id="p365489030165625"><a name="p365489030165625"></a><a name="p365489030165625"></a>A constructor used to create a <strong id="b2057620139165625"><a name="b2057620139165625"></a><a name="b2057620139165625"></a><a href="OHOS-Media-CameraAbility.md">CameraAbility</a></strong> instance. </p>
</td>
</tr>
<tr id="row1491535356165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p948199926165625"><a name="p948199926165625"></a><a name="p948199926165625"></a><a href="MultiMedia_CameraAbility.md#ga797435bcd10278e33fb7b6f4951f0d7f">OHOS::Media::CameraAbility::~CameraAbility</a> ()</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p913341613165625"><a name="p913341613165625"></a><a name="p913341613165625"></a>virtual </p>
<p id="p1398063220165625"><a name="p1398063220165625"></a><a name="p1398063220165625"></a>A destructor used to delete the <strong id="b213982537165625"><a name="b213982537165625"></a><a name="b213982537165625"></a><a href="OHOS-Media-CameraAbility.md">CameraAbility</a></strong> instance. </p>
</td>
</tr>
<tr id="row1952825735165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p279649834165625"><a name="p279649834165625"></a><a name="p279649834165625"></a><a href="MultiMedia_CameraAbility.md#ga840850d531b96cc5a829b257ade3c7e6">OHOS::Media::CameraAbility::GetSupportedSizes</a> (int format) const</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p779752790165625"><a name="p779752790165625"></a><a name="p779752790165625"></a>std::list&lt; CameraPicSize &gt; </p>
<p id="p1708677298165625"><a name="p1708677298165625"></a><a name="p1708677298165625"></a>Obtains the supported image sizes for a specified image format. </p>
</td>
</tr>
<tr id="row1754453049165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p749937802165625"><a name="p749937802165625"></a><a name="p749937802165625"></a><a href="MultiMedia_CameraAbility.md#ga23410306b850fe7edcb736f50fe8048d">OHOS::Media::CameraAbility::SetParameterRange</a> (uint32_t key, std::list&lt; T &gt; rangeList)</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2017067216165625"><a name="p2017067216165625"></a><a name="p2017067216165625"></a>template&lt;typename T &gt; int32_t </p>
<p id="p1484943995165625"><a name="p1484943995165625"></a><a name="p1484943995165625"></a>Sets value ranges for a specified parameter. </p>
</td>
</tr>
<tr id="row1439000424165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1955823406165625"><a name="p1955823406165625"></a><a name="p1955823406165625"></a><a href="MultiMedia_CameraAbility.md#ga3fb9142cc5bbeafef3201ecaaf50c737">OHOS::Media::CameraAbility::GetParameterRange</a> (uint32_t key) const</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p285420957165625"><a name="p285420957165625"></a><a name="p285420957165625"></a>template&lt;typename T &gt; std::list&lt; T &gt; </p>
<p id="p2064329154165625"><a name="p2064329154165625"></a><a name="p2064329154165625"></a>Obtains the parameter value range based on a specified parameter key. </p>
</td>
</tr>
</tbody>
</table>

## **Details**<a name="section1351292470165625"></a>

## **Function **<a name="section23304000165625"></a>

## CameraAbility\(\)<a name="ga7f1b94b32f7c7b121ea14b3147788497"></a>

```
OHOS::Media::CameraAbility::CameraAbility ()
```

 **Description:**

A constructor used to create a  **[CameraAbility](OHOS-Media-CameraAbility.md)**  instance. 

## GetParameterRange\(\)<a name="ga3fb9142cc5bbeafef3201ecaaf50c737"></a>

```
std::list<T> OHOS::Media::CameraAbility::GetParameterRange (uint32_t key) const
```

 **Description:**

Obtains the parameter value range based on a specified parameter key. 

**Parameters:**

<a name="table1853879664165625"></a>
<table><thead align="left"><tr id="row269539406165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p976332592165625"><a name="p976332592165625"></a><a name="p976332592165625"></a>Name</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p1217506138165625"><a name="p1217506138165625"></a><a name="p1217506138165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row1251956493165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 ">key</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 ">Indicates the parameter key. </td>
</tr>
</tbody>
</table>

**Returns:**

Returns the parameter value range if obtained; returns  **NULL**  otherwise. 

## GetSupportedSizes\(\)<a name="ga840850d531b96cc5a829b257ade3c7e6"></a>

```
std::list<CameraPicSize> OHOS::Media::CameraAbility::GetSupportedSizes (int format) const
```

 **Description:**

Obtains the supported image sizes for a specified image format. 

**Parameters:**

<a name="table664064033165625"></a>
<table><thead align="left"><tr id="row143395444165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p811083502165625"><a name="p811083502165625"></a><a name="p811083502165625"></a>Name</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p1238666069165625"><a name="p1238666069165625"></a><a name="p1238666069165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row1799204703165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 ">format</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 ">Indicates the image format, which can be YUV, H.265, or H.264. </td>
</tr>
</tbody>
</table>

**Returns:**

Returns the image size list if obtained; returns  **NULL**  otherwise. 

## SetParameterRange\(\)<a name="ga23410306b850fe7edcb736f50fe8048d"></a>

```
int32_t OHOS::Media::CameraAbility::SetParameterRange (uint32_t key, std::list< T > rangeList )
```

 **Description:**

Sets value ranges for a specified parameter. 

**Parameters:**

<a name="table865722346165625"></a>
<table><thead align="left"><tr id="row1985622562165625"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p457420672165625"><a name="p457420672165625"></a><a name="p457420672165625"></a>Name</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p272375130165625"><a name="p272375130165625"></a><a name="p272375130165625"></a>Description</p>
</th>
</tr>
</thead>
<tbody><tr id="row1456797159165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 ">key</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 ">Indicates the parameter key. </td>
</tr>
<tr id="row1231937533165625"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 ">rangeList</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 ">Indicates the list of parameter value ranges. </td>
</tr>
</tbody>
</table>

**Returns:**

Returns  **SUCCESS**  if the setting is successful; returns  **FAIL**  otherwise. 

## \~CameraAbility\(\)<a name="ga797435bcd10278e33fb7b6f4951f0d7f"></a>

```
virtual OHOS::Media::CameraAbility::~CameraAbility ()
```

 **Description:**

A destructor used to delete the  **[CameraAbility](OHOS-Media-CameraAbility.md)**  instance.