# WhiteCombinePlayer Class Reference (/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
Whiteboard iOS SDK 2.16.147 公开接口。
@interface WhiteCombinePlayer: NSObject
## 成员 [#成员]
- [nativePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/nativePlayer)
- [whitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/whitePlayer)
- [delegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/delegate)
- [playbackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/playbackSpeed)
- [pauseReason](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/pauseReason)
- [initWithNativePlayer\:whitePlayer:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/initWithNativePlayer:whitePlayer:)
- [initWithMediaUrl\:whitePlayer:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/initWithMediaUrl:whitePlayer:)
- [initWithMediaUrl:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/initWithMediaUrl:)
- [initWithNativePlayer:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/initWithNativePlayer:)
- [initWithWhitePlayer:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/initWithWhitePlayer:)
- [videoDuration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/videoDuration)
- [play](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/play)
- [pause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/pause)
- [seekToTime\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/seekToTime:completionHandler:)
- [updateWhitePlayerPhase:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-combine-player#//api/name/updateWhitePlayerPhase:)
### `nativePlayer` [#nativeplayer]
@property (nonatomic, strong, readonly, nullable) AVPlayer *nativePlayer;
Declared in NativeReplayer/WhiteCombinePlayer.h
### `whitePlayer` [#whiteplayer]
@property (nonatomic, strong, nullable, readwrite) WhitePlayer *whitePlayer;
```text
白板回放播放器。详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `delegate` [#delegate]
@property (nonatomic, weak, nullable) id<WhiteCombineDelegate> delegate;
```text
白板回放回调。详见 [WhiteCombineDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-combine-delegate)。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `playbackSpeed` [#playbackspeed]
@property (nonatomic, assign) CGFloat playbackSpeed;
```text
白板回放的播放速率。即使暂停回放,该值也不会变为 0。详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `pauseReason` [#pausereason]
@property (nonatomic, assign, readonly) NSUInteger pauseReason;
```text
白板回放的暂停原因。详见 [WhiteSyncManagerPauseReason](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/constants/white-sync-manager-pause-reason)。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– initWithNativePlayer:whitePlayer:` [#-initwithnativeplayerwhiteplayer]
\- (instancetype)initWithNativePlayer:(AVPlayer *)nativePlayer whitePlayer:(WhitePlayer *)replayer;
```text
初始化一个同时持有本地音视频播放器与白板回放播放器的混合播放器对象。
@param nativePlayer 本地视频播放器。
@param replayer 白板回放播放器。详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
@return 初始化的 `WhiteCombinePlayer` 对象。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– initWithMediaUrl:whitePlayer:` [#-initwithmediaurlwhiteplayer]
\- (instancetype)initWithMediaUrl:(NSURL *)mediaUrl whitePlayer:(WhitePlayer *)replayer;
```text
指定媒体资源地址并初始化混合播放器。
@param mediaUrl 媒体资源地址。
@param replayer 白板回放播放器。详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
@return 初始化的 `WhiteCombinePlayer` 对象。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– initWithMediaUrl:` [#-initwithmediaurl]
\- (instancetype)initWithMediaUrl:(NSURL *)mediaUrl;
```text
指定媒体资源地址并初始化本地播放器(AV Player),需要在生成后,自行设置白板播放器属性。
@param mediaUrl 媒体资源地址。
@return 初始化的 `WhiteCombinePlayer` 对象。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– initWithNativePlayer:` [#-initwithnativeplayer]
\- (instancetype)initWithNativePlayer:(AVPlayer *)nativePlayer;
```text
初始化本地视频播放器(AV Player),需要在生成后,自行设置白板播放器属性。
@param nativePlayer 本地视频播放器。
@return 初始化的 `WhiteCombinePlayer` 对象。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– initWithWhitePlayer:` [#-initwithwhiteplayer]
\- (instancetype)initWithWhitePlayer:(WhitePlayer *)replayer;
```text
使用单独的WhitePlayer来初始化,不再设置AVPlayer
@param replayer 白板回放播放器。详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
@return 初始化的 `WhiteCombinePlayer` 对象。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– videoDuration` [#-videoduration]
\- (NSTimeInterval)videoDuration;
```text
视频回放的持续时长。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– play` [#-play]
\- (void)play;
```text
播放视频。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– pause` [#-pause]
\- (void)pause;
```text
暂停播放视频。
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– seekToTime:completionHandler:` [#-seektotimecompletionhandler]
\- (void)seekToTime:(CMTime)time completionHandler:(void (^)(BOOL finished))completionHandler;
```text
定位到视频指定位置。
定位到本地视频播放器的指定位置后,你可以调用该方法,将白板回放播放器调整到对应位置。
@param time 时间长度(s)。
@param completionHandler 调用结果:
- `YES`:调用已经完成。
- `No`:调用未完成。
*NOTE:** 如果是单白板没有native player的情况下seek会直接返回YES
```
Declared in NativeReplayer/WhiteCombinePlayer.h
### `– updateWhitePlayerPhase:` [#-updatewhiteplayerphase]
\- (void)updateWhitePlayerPhase:(WhitePlayerPhase)phase;
```text
更新白板回放播放器的播放状态。
当白板回放播放器的播放状态发生变化时,White Player 会触发该回调,向你报告板回放播放器的播放状态。
@param phase [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player) 的播放状态。
*Note:** 在该回调中,需要主动调用 [WhitePlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/constants/white-player-phase) 方法,将状态同步给 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
```
Declared in NativeReplayer/WhiteCombinePlayer.h