# Player (/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```ts
export declare interface Player extends Displayer
```
## 成员 [#成员]
- [roomUUID](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#roomuuid)
- [slice](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#slice)
- [isPlayable](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#isplayable)
- [phase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#phase)
- [state](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#state)
- [progressTime](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#progresstime)
- [timeDuration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#timeduration)
- [framesCount](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#framescount)
- [beginTimestamp](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#begintimestamp)
- [playbackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#playbackspeed)
- [play](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#play)
- [pause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#pause)
- [stop](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#stop)
- [seekToProgressTime](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#seektoprogresstime)
- [setObserverMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/web/interfaces/player#setobservermode)
## 继承自 Displayer [#继承自-displayer]
## Properties [#properties]
### roomUUID [#roomuuid]
readonly roomUUID: string;
```text
录像所属的房间 UUID
```
### slice [#slice]
readonly slice: string;
```text
当前录像所属的分片唯一识别符
```
### isPlayable [#isplayable]
readonly isPlayable: boolean;
```text
当前是否能立即播放(可能会缓冲)
```
### phase [#phase]
readonly phase: PlayerPhase;
```text
回放播放器连接的阶段
```
### state [#state]
readonly state: PlayerState;
```text
业务状态
阅读 [《房间与回放的业务状态管理》](/javascript-zh/home/business-state-management) 、[《房间业务状态管理》](/document-zh/home/business-state-management) 以了解更多。
```
### progressTime [#progresstime]
readonly progressTime: number;
```text
播放进度(毫秒),录像开始时为 0
```
### timeDuration [#timeduration]
readonly timeDuration: number;
```text
录像时长(毫秒)
```
### framesCount [#framescount]
readonly framesCount: number;
```text
录像总帧数
```
### beginTimestamp [#begintimestamp]
readonly beginTimestamp: number;
```text
录像开始的绝对时间戳(unix 时间,毫秒)
```
### playbackSpeed [#playbackspeed]
playbackSpeed: number;
```text
播放速度倍率,取 1.0 表明正常速度播放
```
### callbacks [#callbacks]
readonly callbacks: Callbacks<CALLBACKS>;
### observerId [#observerid]
readonly observerId: number;
### region [#region]
readonly region: string;
### version [#version]
readonly version: string;
### deviceType [#devicetype]
readonly deviceType: DeviceType;
### screenType [#screentype]
readonly screenType: ScreenType;
### enableWriteNow [#enablewritenow]
readonly enableWriteNow: boolean;
### handToolKey [#handtoolkey]
readonly handToolKey: string | undefined;
### views [#views]
readonly views: Views;
### useMobXState [#usemobxstate]
readonly useMobXState: boolean;
### useMultiViews [#usemultiviews]
readonly useMultiViews: boolean;
### handToolActive [#handtoolactive]
handToolActive: boolean;
### disableOthersSelectingBox [#disableothersselectingbox]
disableOthersSelectingBox: boolean;
### disableCameraTransform [#disablecameratransform]
disableCameraTransform: boolean;
### commandWheelToZoom [#commandwheeltozoom]
commandWheelToZoom: boolean;
## Methods [#methods]
### play [#play]
play(): void;
```text
播放
```
void
### pause [#pause]
pause(): void;
```text
暂停
```
void
### stop [#stop]
stop(): void;
```text
停止
```
void
### seekToProgressTime [#seektoprogresstime]
seekToProgressTime(progressTime: number): Promise<PlayerSeekingResult>;
```text
跳转到特定进度
```
Promise<PlayerSeekingResult>
### setObserverMode [#setobservermode]
setObserverMode(observerMode: ObserverMode): void;
```text
修改观察模式
```
void
### refreshViewSize [#refreshviewsize]
refreshViewSize(): void;
void
### setCameraBound [#setcamerabound]
setCameraBound(cameraBound: CameraBound): void;
void
### createScenesCallback [#createscenescallback]
createScenesCallback(path: string, callbacks?: Partial<ScenesCallbacks>): ScenesCallbacksNode | null;
ScenesCallbacksNode | null
### memberState [#memberstate]
memberState(memberId: number): MemberState;
MemberState
### moveCamera [#movecamera]
moveCamera(camera: Partial<Camera> & Readonly<\{ animationMode?: AnimationMode; \}>): void;
void
### moveCameraToContain [#movecameratocontain]
moveCameraToContain(rectangle: Rectangle & Readonly<\{ animationMode?: AnimationMode; \}>): void;
void
### bindHtmlElement [#bindhtmlelement]
bindHtmlElement(element: HTMLDivElement | null): void;
void
### getInvisiblePlugin [#getinvisibleplugin]
getInvisiblePlugin<A extends Object, MA extends Object>(kind: string): InvisiblePlugin<A, MA> | null;
InvisiblePlugin<A, MA> | null
### convertToPointInWorld [#converttopointinworld]
convertToPointInWorld(point: \{ x: number; y: number; \}): \{ x: number; y: number; \};
\{ x: number; y: number; \}
### scenePreview [#scenepreview]
scenePreview(scenePath: string, div: HTMLElement, width?: number, height?: number, engine?: RenderEngine): void;
void
### generateScreenshot [#generatescreenshot]
generateScreenshot(scenePath?: string, width?: number, height?: number): Promise<string>;
Promise<string>
### fillSceneSnapshot [#fillscenesnapshot]
fillSceneSnapshot(scenePath: string, div: HTMLElement, width?: number, height?: number, engine?: RenderEngine): void;
void
### screenshotToCanvas [#screenshottocanvas]
screenshotToCanvas(context: CanvasRenderingContext2D, scenePath: string, width: number, height: number, camera: Camera, ratio?: number): void;
void
### screenshotToCanvasAsync [#screenshottocanvasasync]
screenshotToCanvasAsync(context: CanvasRenderingContext2D, scenePath: string, width: number, height: number, camera: Camera, ratio?: number, timeout?: number): Promise<void>;
Promise<void>
### getBoundingRect [#getboundingrect]
getBoundingRect(scenePath: string): Rectangle;
Rectangle
### addMagixEventListener [#addmagixeventlistener]
addMagixEventListener(event: string, listener: EventListener, options?: MagixEventListenerOptions): void;
addMagixEventListener(event: string, listener: EventsListener, fireInterval: number): void;
void
void
### removeMagixEventListener [#removemagixeventlistener]
removeMagixEventListener(event: string, listener?: EventListener): void;
void
### waitMagixEvent [#waitmagixevent]
waitMagixEvent(filter: EventFilter): Promise<Event>;
Promise<Event>
### scalePptToFit [#scaleppttofit]
scalePptToFit(animationMode?: AnimationMode): void;
void
### scenePathType [#scenepathtype]
scenePathType(path: string): ScenePathType;
ScenePathType
### entireScenes [#entirescenes]
entireScenes(): SceneMap;
SceneMap
### getScene [#getscene]
getScene(path: string): WhiteScene | undefined;
WhiteScene | undefined