---
name: "IpcPlayerContext.startRecord"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "IpcContext.startRecord - 开始录像"
---

## IpcPlayerContext.startRecord

> [VERSION] 基础库 >= 2.21.8

### 描述

开始录像

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `options` | `IpcStartRecordOption` | 否 | 录像配置 |

### 返回值

无


### 引用对象

##### `interface` IpcStartRecordOption

| 属性 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `saveToAlbum` | `0 \| 1` | 否 | 是否保存到相册，0 不保存，1 保存 |
| `rotate` | `0 \| 1 \| 2 \| 3` | 否 | 旋转角度，0 不旋转，1 旋转 90°，2 旋转 180°，3 旋转 270° |
| `success` | `() => void` | 否 | 接口调用成功的回调函数 |
| `fail` | `(result: IpcFailResult) => void` | 否 | 接口调用失败的回调函数 |
| `complete` | `() => void` | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |

##### `interface` IpcFailResult

| 属性 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `errorCode` | `string` | 是 | 错误码 |
| `errorMsg` | `string` | 是 | 错误信息 |


### 示例代码

#### 开始录像

```ts
const ipcCtx = ty.createIpcPlayerContext('deviceId');
ipcCtx.startRecord({
  saveToAlbum: 0,
  success() {
    console.log('录像已开始');
  },
});
```