---
name: "recordTransferTask"
mode: "kit"
versionRequirements:
  - { name: "WearKit", version: "1.0.0" }
  - { name: "@ray-js/ray", version: "1.7.14" }
platform:
  - "iOS"
  - "Android"
async: true
title: "wear.recordTransferTask - 获取录音转写任务信息"
---

## recordTransferTask

> [VERSION] WearKit >= 1.0.0 | @ray-js/ray >= 1.7.14

> [PLATFORM] iOS, Android

> ⚡ **支持 Promise 调用** — 不传 success / fail / complete 回调时，该方法返回 Promise。

### 描述

获取录音转写任务

### 参数

| 属性 | 类型 | 必填 | 默认值 | 最低版本 | 描述 |
| --- | --- | --- | --- | --- | --- |
| `deviceId` | `string` | 否 | - | `1.0.0` | 设备id,为为空可查询当前APP是否有录音任务 |
| `complete` | `() => void` | 否 | - | - | 接口调用结束的回调函数（调用成功、失败都会执行） |
| `success` | `(params: Object) => void` ↓见下方 | 否 | - | - | 接口调用成功的回调函数 |
| `fail` | `(params: Object) => void` ↓见下方 | 否 | - | - | 接口调用失败的回调函数 |

#### success 回调参数

| 属性 | 类型 | 最低版本 | 描述 |
| --- | --- | --- | --- |
| `task` | `RecordTransferTask` | `1.0.0` | 录音任务信息 |

#### fail 回调参数

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `errorMsg` | `string` | 错误信息 |
| `errorCode` | `string \| number` | 错误码 |
| `innerError` | `Object` | 错误扩展 |

##### fail(params).innerError 的属性

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `errorCode` | `string \| number` | 错误扩展码 |
| `errorMsg` | `string` | 错误扩展信息 |


### 错误码

| 错误码 | 错误信息 |
| --- | --- |
| `10001` | 内部错误 |
| `10048` | 设备未在录音中 |

### 引用对象

##### `interface` RecordTransferTask

| 属性 | 类型 | 最低版本 | 描述 |
| --- | --- | --- | --- |
| `state` | `number` | `3.0.0` | 状态，0未知，1录音中，2暂停，3结束 |
| `devId` | `string` | `3.0.0` | 当前录音的设备id |
| `userRecordDuration` | `number` | `3.0.0` | 用户录音时间 单位毫秒 |
| `recordType` | `number` | `3.0.0` | 音频类型 0呼叫 1会议 2同声传译 |
| `transferType` | `number` | `3.0.0` | 转写模式 0文件转写，1实时转写 |
| `needTranslate` | `boolean` | `3.0.0` | 是否需要翻译 |
| `needTts` | `boolean` | `3.0.0` | 是否需要TTS |
| `originalLanguage` | `string` | `3.0.0` | 会议或者电话模式，表示起始语言 同声传译模式，表示左耳语言 |
| `targetLanguage` | `string` | `3.0.0` | 会议或者电话模式，表示目标语言 同声传译模式，表示右耳语言 |
| `isStarting` | `boolean` | `3.0.0` | 是否正在开始中 |
| `isPausing` | `boolean` | `3.0.0` | 是否正在暂停中 |
| `isResuming` | `boolean` | `3.0.0` | 是否正在恢复中 |
| `isStoping` | `boolean` | `3.0.0` | 是否正在结束中 |
| `currentRealTimeAsrId` | `string` | `3.0.0` | 当前正在实时转写的asrId |
| `recordId` | `string` | `3.0.0` | 实时转写记录id |
| `audioSource` | `number` | `3.0.0` | 音频输入源，见AudioSource枚举值 //系统音频源 0-19 SYSTEM_BLUETOOTH_16K_MONO(0),//系统蓝牙 16KHz单声道 SYSTEM_PHONE_MIC_16K_MONO(1),//系统MIC 16Hz单声道 //耳机输入源 20-39 EARPHONE_PRO_16K_MONO(20),//耳机16KHz单声道 EARPHONE_PRO_16K_STEREO(21),//耳机16KHz双声道 EARPHONE_PRO_32K_MONO(22),//卡片32KHz单声道 //卡片输入源40-59 NOTE_16K_MONO(40),//卡片16KHz单声道 NOTE_16K_STEREO(41),//卡片16KHz双声道 |
| `businessType` | `number` | `3.0.0` | 业务类型 0: Note, 1: Translate |


### 示例代码

#### 基础用法

```tsx
import { wear } from '@ray-js/ray'

wear.recordTransferTask({
  deviceId: 'dev',
  success: (result) => {
    console.log('recordTransferTask success', result.task);
  },
  fail: error => {
    console.error(error);
  },
});
```

> 相关链接：[https://developer.tuya.com/](https://developer.tuya.com/)