# IndividualScenario 类 (/zh-CN/api-reference/cloud-recording/java-api/individualscenario.java)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="acquire"></a>
## acquire [#acquire]

```java
public abstract Mono<AcquireResourceRes> acquire(String cname, String uid, boolean enablePostpone, AcquireIndividualResourceClientReq clientRequest);
```

获取单流录制的资源 ID。

:::info[信息]
自 v0.4.0 版本新增。
:::

获取资源 ID 后，需调用 [`start`](/zh-CN/api-reference/cloud-recording/java-api/individualscenario.java#start) API 启动云端录制。

#### 参数 [#参数]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `cname` | `String` | 待录制的频道名称。 |
| `uid` | `String` | 云录制服务在 RTC 频道中使用的用户 ID，用于标识录制服务。 |
| `enablePostpone` | `boolean` | [individualscenario-java-html-0-3-2 details](#table-slot-individualscenario-java-html-0-3-2) |
| `clientRequest` | `AcquireIndividualResourceClientReq` | 请求体参数，详见 [`AcquireIndividualResourceClientReq`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#acquireindividualresourceclientreq)。 |

<a id="table-slot-individualscenario-java-html-0-3-2"></a>

**individualscenario-java-html-0-3-2 details**

- `true`：延迟开始录制。
- `false`：立即开始录制。

#### 返回值 [#返回值]

方法调用成功，返回 [`AcquireResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#acquireresourceres) 对象。

<a id="start"></a>
## start [#start]

```java
public abstract Mono<StartResourceRes> start(String cname, String uid, String resourceId, StartIndividualRecordingClientReq clientRequest);
```

启动单流云端录制。

:::info[信息]
自 v0.4.0 版本新增。
:::

#### 参数 [#参数-1]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `cname` | `String` | 频道名称。 |
| `uid` | `String` | 用户 ID。 |
| `resourceId` | `String` | 资源 ID。 |
| `clientRequest` | `StartIndividualRecordingClientReq` | 请求体参数，详见 [`StartIndividualRecordingClientReq`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#startindividualrecordingclientreq)。 |

#### 返回值 [#返回值-1]

方法调用成功，返回 [`StartResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#startresourceres) 对象。

<a id="query"></a>
## query [#query]

```java
public abstract Mono<QueryIndividualRecordingResourceRes> query(String resourceId, String sid);
```

查询关闭视频截图采集时的单路云端录制状态。

:::info[信息]
自 v0.4.0 版本新增。
:::

#### 参数 [#参数-2]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `resourceId` | `String` | 资源 ID。 |
| `sid` | `String` | 录制 ID，用于标识一次录制周期。 |

#### 返回值 [#返回值-2]

方法调用成功，返回 [`QueryIndividualRecordingResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#queryindividualrecordingresourceres) 对象。

<a id="queryresourceresqueryvideoscreenshot"></a>

<a id="queryvideoscreenshot"></a>
## queryVideoScreenshot [#queryvideoscreenshot]

```java
public abstract Mono<QueryIndividualRecordingVideoScreenshotResourceRes> queryVideoScreenshot(String resourceId, String sid);
```

查询开启视频截图时单路云端录制的状态。

:::info[信息]
自 v0.4.0 版本新增。
:::

#### 参数 [#参数-3]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `resourceId` | `String` | 资源 ID。 |
| `sid` | `String` | 录制 ID，用于标识一次录制周期。 |

#### 返回值 [#返回值-3]

方法调用成功时，返回 [`QueryIndividualRecordingVideoScreenshotResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#queryindividualrecordingvideoscreenshotresourceres) 对象。

<a id="update"></a>
## update [#update]

```java
public abstract Mono<UpdateResourceRes> update(String cname, String uid, String resourceId, String sid, UpdateIndividualRecordingResourceClientReq clientRequest);
```

更新单流录制配置。

:::info[信息]
自 v0.4.0 版本新增。
:::

#### 参数 [#参数-4]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `cname` | `String` | 频道名称。 |
| `uid` | `String` | 用于标识录制服务在 RTC 频道中的用户 ID。 |
| `resourceId` | `String` | 资源 ID。 |
| `sid` | `String` | 录制 ID，用于标识一次录制周期。 |
| `clientRequest` | `UpdateIndividualRecordingResourceClientReq` | 请求体，详见 [`UpdateIndividualRecordingResourceClientReq`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#updateindividualrecordingresourceclientreq)。 |

#### 返回值 [#返回值-4]

方法调用成功，返回 [`UpdateResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#updateresourceres) 对象。

<a id="stop"></a>
## stop [#stop]

```java
public abstract Mono<StopResourceRes> stop(String cname, String uid, String resourceId, String sid, boolean asyncStop);
```

停止单流录制。

:::info[信息]
自 v0.4.0 版本新增。
:::

#### 参数 [#参数-5]

| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `cname` | `String` | 频道名称。 |
| `uid` | `String` | 云端录制服务在 RTC 频道中使用的用户 ID，用于标识录制服务。 |
| `resourceId` | `String` | 资源 ID。 |
| `sid` | `String` | 录制 ID，用于标识一次录制周期。 |
| `asyncStop` | `boolean` | [individualscenario-java-html-5-5-2 details](#table-slot-individualscenario-java-html-5-5-2) |

<a id="table-slot-individualscenario-java-html-5-5-2"></a>

**individualscenario-java-html-5-5-2 details**

- `true`：异步停止录制。
- `false`：同步停止录制。

#### 返回值 [#返回值-5]

方法调用成功，返回 [`StopResourceRes`](/zh-CN/api-reference/cloud-recording/java-api/struct.java#stopresourceres) 对象。