# avtranscoder_base.h
<!--Kit: Media Kit-->
<!--Subsystem: Multimedia-->
<!--Owner: @wang-haizhou6-->
<!--Designer: @HmQQQ-->
<!--Tester: @xchaosioda-->
<!--Adviser: @zengyawen-->

## 概述

定义了媒体AVTranscoder的结构体和枚举。

**引用文件：** <multimedia/player_framework/avtranscoder_base.h>

**库：** libavtranscoder.so

**系统能力：** SystemCapability.Multimedia.Media.AVTranscoder

**起始版本：** 20

**相关模块：** [AVTranscoder](capi-avtranscoder.md)

## 汇总

### 结构体

| 名称 | typedef关键字 | 描述 |
| -- | -- | -- |
| [OH_AVTranscoder](capi-avtranscoder-oh-avtranscoder.md) | OH_AVTranscoder | 初始化AVTranscoder。 |
| [OH_AVTranscoder_Config](capi-avtranscoder-oh-avtranscoder-config.md) | OH_AVTranscoder_Config | 初始化AVTranscoder_Config。 |

### 枚举

| 名称 | typedef关键字 | 描述 |
| -- | -- | -- |
| [OH_AVTranscoder_State](#oh_avtranscoder_state) | OH_AVTranscoder_State | 转码状态。 |

### 函数

| 名称 | typedef关键字 | 描述 |
| -- | -- | -- |
| [typedef void (\*OH_AVTranscoder_OnStateChange)(OH_AVTranscoder *transcoder, OH_AVTranscoder_State state, void *userData)](#oh_avtranscoder_onstatechange) | OH_AVTranscoder_OnStateChange | 转码过程的状态回调函数。 |
| [typedef void (\*OH_AVTranscoder_OnError)(OH_AVTranscoder *transcoder, int32_t errorCode, const char *errorMsg, void *userData)](#oh_avtranscoder_onerror) | OH_AVTranscoder_OnError | 转码过程中错误事件的回调函数。 |
| [typedef void (\*OH_AVTranscoder_OnProgressUpdate)(OH_AVTranscoder *transcoder, int32_t progress, void *userData)](#oh_avtranscoder_onprogressupdate) | OH_AVTranscoder_OnProgressUpdate | 回调转码进度更新时调用。 |

## 枚举类型说明

### OH_AVTranscoder_State

```
enum OH_AVTranscoder_State
```

**描述**

转码状态。

**系统能力：** SystemCapability.Multimedia.Media.AVTranscoder

**起始版本：** 20

| 枚举项 | 描述 |
| -- | -- |
| AVTRANSCODER_PREPARED = 1 | 准备 |
| AVTRANSCODER_STARTED = 2 | 开始 |
| AVTRANSCODER_PAUSED = 3 | 暂停 |
| AVTRANSCODER_CANCELLED = 4 | 取消 |
| AVTRANSCODER_COMPLETED = 5 | 完成 |


## 函数说明

### OH_AVTranscoder_OnStateChange()

```
typedef void (*OH_AVTranscoder_OnStateChange)(OH_AVTranscoder *transcoder, OH_AVTranscoder_State state, void *userData)
```

**描述**

转码过程的状态回调函数。

**系统能力：** SystemCapability.Multimedia.Media.AVTranscoder

**起始版本：** 20


**参数：**

| 参数项 | 描述 |
| -- | -- |
| [OH_AVTranscoder](capi-avtranscoder-oh-avtranscoder.md) *transcoder | OH_AVTranscoder实例的指针。 |
| [OH_AVTranscoder_State](#oh_avtranscoder_state) state | 转码状态，详细说明请参见[OH_AVTranscoder_State](#oh_avtranscoder_state)。 |
|  void *userData | 用户特定数据的指针。 |

### OH_AVTranscoder_OnError()

```
typedef void (*OH_AVTranscoder_OnError)(OH_AVTranscoder *transcoder, int32_t errorCode, const char *errorMsg,void *userData)
```

**描述**

转码过程中错误事件的回调函数。

**系统能力：** SystemCapability.Multimedia.Media.AVTranscoder

**起始版本：** 20


**参数：**

| 参数项 | 描述 |
| -- | -- |
| [OH_AVTranscoder](capi-avtranscoder-oh-avtranscoder.md) *transcoder | OH_AVTranscoder实例的指针。 |
| int32_t errorCode | 错误码。<br>                  AV_ERR_NO_MEMORY：无内存，取值为1。<br>                  AV_ERR_OPERATE_NOT_PERMIT：操作不允许，取值为2。<br>                  AV_ERR_INVALID_VAL：参数检查失败，取值为3。<br>                  AV_ERR_IO：IO错误，取值为4。<br>                  AV_ERR_INVALID_STATE：当前状态不支持此操作，取值为8。<br>                  AV_ERR_UNSUPPORT：未支持的接口，取值为9。 |
| const char *errorMsg | 错误消息。 |
| void *userData | 用户特定数据的指针。 |

### OH_AVTranscoder_OnProgressUpdate()

```
typedef void (*OH_AVTranscoder_OnProgressUpdate)(OH_AVTranscoder *transcoder, int32_t progress, void *userData)
```

**描述**

回调转码进度更新时调用。

**系统能力：** SystemCapability.Multimedia.Media.AVTranscoder

**起始版本：** 20


**参数：**

| 参数项 | 描述 |
| -- | -- |
| [OH_AVTranscoder](capi-avtranscoder-oh-avtranscoder.md) *transcoder | OH_AVTranscoder实例的指针。 |
| int32_t progress | 转码进度。 |
| void *userData | 用户特定数据的指针。 |