# WhiteConverter Class Reference (/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
Whiteboard iOS SDK 2.16.147 公开接口。
@interface WhiteConverter: NSObject
## 成员 [#成员]
- [init](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/init)
- [initWithRoomToken:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/initWithRoomToken:)
- [initWithRoomToken\:pollingInterval\:timeout:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/initWithRoomToken:pollingInterval:timeout:)
- [roomToken](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/roomToken)
- [interval](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/interval)
- [timeout](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/timeout)
- [taskId](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/taskId)
- [error](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/error)
- [type](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/type)
- [status](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/status)
- [startConvertTask\:type\:progress\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/startConvertTask:type:progress:completionHandler:)
- [startPolling\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-converter#//api/name/startPolling:completionHandler:)
### `– init` [#-init]
\- (instancetype)init NS_UNAVAILABLE;
Declared in Converter/V4/WhiteConverter.h
### `– initWithRoomToken:` [#-initwithroomtoken]
\- (instancetype)initWithRoomToken:(NSString *)roomToken;
Declared in Converter/V4/WhiteConverter.h
### `– initWithRoomToken:pollingInterval:timeout:` [#-initwithroomtokenpollingintervaltimeout]
\- (instancetype)initWithRoomToken:(NSString *)roomToken pollingInterval:(NSTimeInterval)interval timeout:(NSTimeInterval)timeout;
Declared in Converter/V4/WhiteConverter.h
### `roomToken` [#roomtoken]
@property (nonatomic, copy, readonly) NSString *roomToken;
Declared in Converter/V4/WhiteConverter.h
### `interval` [#interval]
@property (nonatomic, assign) NSTimeInterval interval;
```text
轮询间隔时间,默认 15s,从前一个请求完整结束,开始计时
```
Declared in Converter/V4/WhiteConverter.h
### `timeout` [#timeout]
@property (nonatomic, assign) NSTimeInterval timeout;
```text
轮询超时停止时间,默认 3 分钟
```
Declared in Converter/V4/WhiteConverter.h
### `taskId` [#taskid]
@property (nonatomic, copy, readonly, nullable) NSString *taskId;
```text
服务器转换任务的 uuid。如遇错,可以提供 taskId 和 type 类型进行排查。
只有成功创建转换任务,才会有 taskId,如果未开启服务
```
Declared in Converter/V4/WhiteConverter.h
### `error` [#error]
@property (nonatomic, strong, readonly, nullable) NSError *error;
```text
错误信息
```
Declared in Converter/V4/WhiteConverter.h
### `type` [#type]
@property (nonatomic, assign, readonly) ConvertType type;
```text
转换类型,在创建转换任务时,传入。
```
Declared in Converter/V4/WhiteConverter.h
### `status` [#status]
@property (nonatomic, assign, readonly) ConverterStatus status;
Declared in Converter/V4/WhiteConverter.h
### `– startConvertTask:type:progress:completionHandler:` [#-startconverttasktypeprogresscompletionhandler]
\- (void)startConvertTask:(NSString *)url type:(ConvertType)type progress:(_Nullable ConvertProgress)progress completionHandler:(_Nullable ConvertCompletionHandler)completionHandler;
```text
创建文档转换服务,并开始轮询请求服务器。
部分状态下无法新建服务,具体看 @link{{ConverterStatus}} 枚举
@param url 文档所在网络地址,需要对外可下载(即使无法下载,也会成功创建转换服务,但是会立即变成转换失败状态),SDK 服务器会去下载,然后进行转换。
@param type 文档类型
@param progress 进度回调提示
@param completionHandler 转换完成回调(主线程回调)
```
Declared in Converter/V4/WhiteConverter.h
### `– startPolling:completionHandler:` [#-startpollingcompletionhandler]
\- (void)startPolling:(_Nullable ConvertProgress)progress completionHandler:(_Nullable ConvertCompletionHandler)completionHandler;
```text
重新轮询执行检查(外部调用时,只有ConverterStatusTimeout,才允许重新开启轮询检查)
间隔与超时时间,继承 启动文档转换服务 API 的设置
@param progress 进度回调
@param completionHandler 转换完成回调(主线程回调)
```
Declared in Converter/V4/WhiteConverter.h