# com.herewhite.sdk.Player类 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player)

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

<a id="details"></a>

## 详细描述 [#详细描述]

<DocsTable>
<thead>
<tr>
<th colSpan={2} scope="colgroup">

<a id="pub-methods"></a> Public 成员函数

</th>
</tr>
</thead>
<tbody>
<tr>
<td>double</td>
<td>[getPlaybackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ac4d5da09b9af9aba4fa3b31dc26980f6) ()</td>
</tr>
<tr>
<td>void</td>
<td>[setPlaybackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#af654c75ee033ccb5d3636c83553b09a6) (double playbackSpeed)</td>
</tr>
<tr>
<td>void</td>
<td>[getPlaybackSpeed](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ad466294818d8245c43d32666c01848a1) (final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; Double &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[play](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a694d6ad377bc1572de892f0139b45e76) ()</td>
</tr>
<tr>
<td>void</td>
<td>[pause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a0dd55afd7520e8698da247b52d3c2127) ()</td>
</tr>
<tr>
<td>void</td>
<td>[stop](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a97a63621cc47b043e577e6c472280ed3) ()</td>
</tr>
<tr>
<td>void</td>
<td>[seekToScheduleTime](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a2cdff830a4a940a377ddffb97fbc54de) (long seekTime)</td>
</tr>
<tr>
<td>void</td>
<td>[setObserverMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a4b611db510d583279ad3aabd6a58bfc5) ([PlayerObserverMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-observer-mode) mode)</td>
</tr>
<tr>
<td>[PlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-phase)</td>
<td>[getPlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#aedec2772fc9d3ab9300da2c207e96b1e) ()</td>
</tr>
<tr>
<td>void</td>
<td>[getPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a70282d3b516dafb6852755e7c7c9aa79) (final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-phase) &gt; promise)</td>
</tr>
<tr>
<td>[PlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state)</td>
<td>[getPlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ad18a956ac130dc58b2b3220e25864efd) ()</td>
</tr>
<tr>
<td>void</td>
<td>[getPlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#afb3235211d0f04c675a4670e8415abaa) (final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state) &gt; promise)</td>
</tr>
<tr>
<td>[PlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info)</td>
<td>[getPlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a180372d211ae3760cbc0c3f9c74e0b6b) ()</td>
</tr>
<tr>
<td>void</td>
<td>[getPlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ad3aa2fc1c1f96fb580d2c8010e178c19) (final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info) &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[addPlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a8ad1cf8a6b7eb05f1c07058a2590bf5f) (@NonNull [PlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener) playerListener)</td>
</tr>
<tr>
<td>void</td>
<td>[removePlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a3086a2d58fb3b24ad47a6d29e4e3d05d) (@NonNull [PlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener) playerListener)</td>
</tr>
<tr>
<td colSpan={2}>Public 成员函数 继承自 [com.herewhite.sdk.Displayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer)</td>
</tr>
<tr>
<td>void</td>
<td>[postIframeMessage](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a218d273792fc859b2f343f9185368407) (String string)</td>
</tr>
<tr>
<td>void</td>
<td>[postIframeMessage](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#aafcea84ae1fc2539996f6d0e2710a362) ([WhiteObject](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-white-object) object)</td>
</tr>
<tr>
<td>void</td>
<td>[getScenePathType](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#ac47409b4e5ca783e080e11e0c032c145) (String path, final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [WhiteScenePathType](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-white-scene-path-type) &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[getScene](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#ac8467c97aecb62aa78d8520dabd108bd) (String path, final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [Scene](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-scene) &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[getEntireScenes](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a8fd708269f78c0a4d8fbee3f3ec465f2) (final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; Map&lt; String, [Scene](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-scene)[]&gt; &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[refreshViewSize](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a20be8e5cc145577cd66706d9012989a6) ()</td>
</tr>
<tr>
<td>void</td>
<td>[scaleIframeToFit](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a65bbfa5b2fd5fa7d0cb1e1cfe03413f7) ()</td>
</tr>
<tr>
<td>void</td>
<td>[scalePptToFit](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a4b8ecbbc38569db7868c25790f191fbe) ()</td>
</tr>
<tr>
<td>void</td>
<td>[scalePptToFit](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a29f2d682f7d728e53767ded3889c60ee) ([AnimationMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-animation-mode) mode)</td>
</tr>
<tr>
<td>void</td>
<td>[addMagixEventListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a5789b995344ae4c9bd0872dfb3fd8cae) (String eventName, [EventListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-event-listener) eventListener)</td>
</tr>
<tr>
<td>void</td>
<td>[addHighFrequencyEventListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a53b433bf7d24a786c4976ba85dee9940) (String eventName, [FrequencyEventListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-frequency-event-listener) eventListener, Integer fireInterval)</td>
</tr>
<tr>
<td>void</td>
<td>[removeMagixEventListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a071edba37f99285bbea69988481eb3ae) (String eventName)</td>
</tr>
<tr>
<td>void</td>
<td>[convertToPointInWorld](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a1bfd39e7482e2937908a2dea49db1c27) (double x, double y, final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [Point](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-point) &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[setCameraBound](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a7ebc499b1f6ca5457d41fcec9bad214e) ([CameraBound](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound) bound)</td>
</tr>
<tr>
<td>void</td>
<td>[setBackgroundColor](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a67b020e6d15247e1bdc7dbd9b86bcfbe) (@ColorInt int intColor)</td>
</tr>
<tr>
<td>int</td>
<td>[getBackgroundColor](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#aa164b4edc632f73ac9a83b3f1bdab64c) ()</td>
</tr>
<tr>
<td>void</td>
<td>[getScenePreviewImage](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a01268dd20584fcebfa1aecc5d98e3616) (String scenePath, final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; Bitmap &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[getSceneSnapshotImage](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a0995da14d5d9b20d5f98c2639018700e) (String scenePath, final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; Bitmap &gt; promise)</td>
</tr>
<tr>
<td>void</td>
<td>[disableCameraTransform](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#a4b4ee486693efafc4683e312244d1129) (Boolean disable)</td>
</tr>
<tr>
<td>void</td>
<td>[moveCamera](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#aa73a9b1c04e23e0f8b1ecb79099d858a) ([CameraConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-config) camera)</td>
</tr>
<tr>
<td>void</td>
<td>[moveCameraToContainer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer#af19ee0561ddd8b547b22040e58309549) ([RectangleConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-rectangle-config) rectangle)</td>
</tr>
</tbody>
</DocsTable>

<DocsTable>
<thead>
<tr>
<th colSpan={2} scope="colgroup">

<a id="inherited"></a> 额外继承的成员函数

</th>
</tr>
</thead>
<tbody>
<tr>
<td colSpan={2}>Protected 成员函数 继承自 [com.herewhite.sdk.Displayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer)</td>
</tr>
<tr>
<td>

<a id="a4d458fff12f71d54244faa1d5d2033f4"></a> void

</td>
<td>**post** (Runnable runnable)</td>
</tr>
<tr>
<td colSpan={2}>Protected 属性 继承自 [com.herewhite.sdk.Displayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer)</td>
</tr>
<tr>
<td>

<a id="a2f502cfaf3e55d4e017b009e2be0ae62"></a> final JsBridgeInterface

</td>
<td>**bridge**</td>
</tr>
<tr>
<td>

<a id="a2b652afa746380527d36fc9ce75841c9"></a> String

</td>
<td>**uuid**</td>
</tr>
<tr>
<td>

<a id="a37d72fc386a43d07e05596a19b3a46d2"></a> int

</td>
<td>**densityDpi**</td>
</tr>
<tr>
<td colSpan={2}>静态 Protected 属性 继承自 [com.herewhite.sdk.Displayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-displayer)</td>
</tr>
<tr>
<td>

<a id="a881a29543fbd8fbb1c985de43626359c"></a> static final Gson

</td>
<td>**gson** = new Gson()</td>
</tr>
</tbody>
</DocsTable>











## 详细描述 [#详细描述-1]

[`Player`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player) 类，用于操作白板的回放。

## 成员函数说明 [#成员函数说明]

## 变量说明 [#变量说明]

<a id="ac4d5da09b9af9aba4fa3b31dc26980f6"></a>

### getPlaybackSpeed() [1/2] [#getplaybackspeed-12]

<ApiSignature>

double com.herewhite.sdk.Player.getPlaybackSpeed()

</ApiSignature>

获取白板回放的倍速。

:::info[自从]
2.5.2
:::

:::info[注解]
- 该方法为同步调用。
- 该方法获取的是播放倍速。例如，当返回值为 `2.0` 时，表示当前得播放速度是原速的 2 倍。
- 回放暂停时，返回值也不会为 0。
:::

<h4 data-toc-hidden="true" id={"返回值"}>返回值</h4>

白板回放的播放倍速。

<a id="ad466294818d8245c43d32666c01848a1"></a>

### getPlaybackSpeed() [2/2] [#getplaybackspeed-22]

<ApiSignature>

void com.herewhite.sdk.Player.getPlaybackSpeed(final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; Double &gt; *promise*)

</ApiSignature>

获取白板回放的倍速。

:::info[自从]
2.5.2
:::

:::info[注解]
- 该方位为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 [`getPlaybackSpeed`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ac4d5da09b9af9aba4fa3b31dc26980f6)[1/2] 获取播放速度。
- 该方法获取的是播放倍速。例如，当返回值为 `2.0` 时，表示当前得播放速度是原速的 2 倍。
- 回放暂停时，返回值也不会为 0。
:::

<ParameterList title="参数">
<Parameter name="promise">

Promise&lt;Double&gt; 接口实例，详见 [`Promise`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)。你可以通过该接口获取 `getPlaybackSpeed` 的调用结果：

- 如果获取成功，将返回白板回放的倍速。
- 如果获取失败，将返回错误信息。

</Parameter>
</ParameterList>

<a id="ad18a956ac130dc58b2b3220e25864efd"></a>

### getPlayerState() [1/2] [#getplayerstate-12]

<ApiSignature>

[PlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state) com.herewhite.sdk.Player.getPlayerState()

</ApiSignature>

获取白板回放的状态。

:::info[自从]
2.4.0
:::

:::info[注解]
- 该方法为同步调用。
- 如果白板回放处于 `waitingFirstFrame` 阶段，则该方法返回 `null`。
:::

<h4 data-toc-hidden="true" id={"返回值-1"}>返回值</h4>

白板回放的状态，详见 [`PlayerState`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state)。

<a id="afb3235211d0f04c675a4670e8415abaa"></a>

### getPlayerState() [2/2] [#getplayerstate-22]

<ApiSignature>

void com.herewhite.sdk.Player.getPlayerState(final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state) &gt; *promise*)

</ApiSignature>

获取白板回放的状态。

:::info[注解]
- 该方法为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 [`getPlayerState`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#ad18a956ac130dc58b2b3220e25864efd)[1/2] 获取。
- 如果白板回放处于 `waitingFirstFrame` 阶段，则该方法返回 `null`。
:::

<ParameterList title="参数">
<Parameter name="promise">

`Promise<PlayerState>` 接口实例，详见 [`Promise`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)。你可以通过该接口获取 `getPlayerState` 方法调用的结果：

- 如果方法调用成功，将返回白板回放状态，详见 [`PlayerState`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-state)。
- 如果方法调用失败，将返回错误信息。

</Parameter>
</ParameterList>

<a id="a180372d211ae3760cbc0c3f9c74e0b6b"></a>

### getPlayerTimeInfo() [1/2] [#getplayertimeinfo-12]

<ApiSignature>

[PlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info) com.herewhite.sdk.Player.getPlayerTimeInfo()

</ApiSignature>

获取白板回放的时间信息。

:::info[自从]
2.4.0
:::

该方法获取的时间信息，包含当前的播放进度，回放的总时长，以及回放的起始时间，单位为毫秒。

:::info[注解]
- 该方法为同步调用。
- 该方法获取的当前播放进度可能不准确。
:::

<h4 data-toc-hidden="true" id={"返回值-2"}>返回值</h4>

白板回放的时间信息，详见 [`PlayerTimeInfo`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info)。

<a id="ad3aa2fc1c1f96fb580d2c8010e178c19"></a>

### getPlayerTimeInfo() [2/2] [#getplayertimeinfo-22]

<ApiSignature>

void com.herewhite.sdk.Player.getPlayerTimeInfo(final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerTimeInfo](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info) &gt; *promise*)

</ApiSignature>

获取白板回放的时间信息，该方法为异步调用。

该方法获取的时间信息，包含当前的播放进度，回放的总时长，以及回放的起始时间，单位为毫秒。

:::info[注解]
该方法为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 [`getPlayerTimeInfo`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a180372d211ae3760cbc0c3f9c74e0b6b) 进行获取。
:::

<ParameterList title="参数">
<Parameter name="promise">

`Promise<PlayerTimeInfo>` 接口实例，详见 [`Promise`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)。你可以通过该接口获取 `getPlayerTimeInfo` 方法的调用结果：

- 如果方法调用成功，将返回白板回放的时间信息，详见 [`PlayerTimeInfo`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-time-info)。
- 如果方法调用失败，将返回错误信息。

</Parameter>
</ParameterList>

## 函数说明 [#函数说明]

<a id="af654c75ee033ccb5d3636c83553b09a6"></a>

### setPlaybackSpeed() [#setplaybackspeed]

<ApiSignature>

void com.herewhite.sdk.Player.setPlaybackSpeed(double *playbackSpeed*)

</ApiSignature>

设置白板回放的倍速。

:::info[自从]
2.5.2
:::

<ParameterList title="参数">
<Parameter name="playbackSpeed">

白板回放的倍速。取值必须大于 0，设为 1 表示按原速播放。

</Parameter>
</ParameterList>

<a id="a694d6ad377bc1572de892f0139b45e76"></a>

### play() [#play]

<ApiSignature>

void com.herewhite.sdk.Player.play()

</ApiSignature>

开始白板回放。

暂停回放后，也可以调用该方法继续白板回放。

<a id="a0dd55afd7520e8698da247b52d3c2127"></a>

### pause() [#pause]

<ApiSignature>

void com.herewhite.sdk.Player.pause()

</ApiSignature>

暂停白板回放。

<a id="a97a63621cc47b043e577e6c472280ed3"></a>

### stop() [#stop]

<ApiSignature>

void com.herewhite.sdk.Player.stop()

</ApiSignature>

停止白板回放。

白板回放停止后，[`Player`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player) 资源会被释放。如果想要重新播放，需要重新初始化 [`Player`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player) 实例。

<a id="a2cdff830a4a940a377ddffb97fbc54de"></a>

### seekToScheduleTime() [#seektoscheduletime]

<ApiSignature>

void com.herewhite.sdk.Player.seekToScheduleTime(long *seekTime*)

</ApiSignature>

设置白板回放的播放位置。

白板回放的起始时间点为 0，成功调用该方法后，白板回放会在指定位置开始播放。

<ParameterList title="参数">
<Parameter name="seekTime">

播放进度，单位为毫秒。

</Parameter>
</ParameterList>

<a id="a4b611db510d583279ad3aabd6a58bfc5"></a>

### setObserverMode() [#setobservermode]

<ApiSignature>

void com.herewhite.sdk.Player.setObserverMode([PlayerObserverMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-observer-mode) *mode*)

</ApiSignature>

设置白板回放的查看模式。

<ParameterList title="参数">
<Parameter name="mode">

白板回放的查看模式，详见 [`PlayerObserverMode`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-observer-mode)。

</Parameter>
</ParameterList>

<a id="aedec2772fc9d3ab9300da2c207e96b1e"></a>

### getPlayerPhase() [#getplayerphase]

<ApiSignature>

[PlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-phase) com.herewhite.sdk.Player.getPlayerPhase()

</ApiSignature>

获取白板回放的阶段。

:::info[自从]
2.4.0
:::

在 [`Player`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player) 生命周期内，你可以调用该方法获取白板回放当前所处的阶段。

:::info[注解]
- 该方法为同步调用。
- 成功调用 [`stop`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a97a63621cc47b043e577e6c472280ed3)、[`play`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a694d6ad377bc1572de892f0139b45e76) 或 [`pause`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a0dd55afd7520e8698da247b52d3c2127) 等方法均会影响白板回放的阶段，但是通过该方法无法立即获取最新的白板回放阶段。 此时，你可以调用 [`getPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a70282d3b516dafb6852755e7c7c9aa79) 获取最新的回放阶段。
:::

<h4 data-toc-hidden="true" id={"返回值-3"}>返回值</h4>

白板回放的阶段，详见 [`PlayerPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-phase)。

<a id="a70282d3b516dafb6852755e7c7c9aa79"></a>

### getPhase() [#getphase]

<ApiSignature>

void com.herewhite.sdk.Player.getPhase(final [Promise](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)&lt; [PlayerPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-player-phase) &gt; *promise*)

</ApiSignature>

获取白板回放的阶段。

在 [`Player`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player) 生命周期内，你可以调用该方法获取白板回放当前所处的阶段。

:::info[注解]
- 该方法为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 [`getPlayerPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#aedec2772fc9d3ab9300da2c207e96b1e) 获取回放阶段。
- 成功调用 [`stop`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a97a63621cc47b043e577e6c472280ed3)、[`play`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a694d6ad377bc1572de892f0139b45e76) 或 [`pause`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a0dd55afd7520e8698da247b52d3c2127) 等方法后，你无法通过 [`getPlayerPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#aedec2772fc9d3ab9300da2c207e96b1e) 立即获取最新的白板回放阶段。 此时，你可以调用 [`getPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-player#a70282d3b516dafb6852755e7c7c9aa79)。
:::

<ParameterList title="参数">
<Parameter name="promise">

`Promise<PlayerPhase>` 接口实例，详见 [`Promise`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1domain-1-1-promise)。你可以通过该接口获取 `getPhase` 方法的调用结果：

- 如果方法调用成功，将返回白板回放的阶段。
- 如果方法调用失败，将返回错误信息。

</Parameter>
</ParameterList>

<a id="a8ad1cf8a6b7eb05f1c07058a2590bf5f"></a>

### addPlayerListener() [#addplayerlistener]

<ApiSignature>

void com.herewhite.sdk.Player.addPlayerListener(@NonNull [PlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener) *playerListener*)

</ApiSignature>

添加白板回放的回调。

<ParameterList title="参数">
<Parameter name="playerListener">

白板回放的回调。详见 [`PlayerListener`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener)。

</Parameter>
</ParameterList>

<a id="a3086a2d58fb3b24ad47a6d29e4e3d05d"></a>

### removePlayerListener() [#removeplayerlistener]

<ApiSignature>

void com.herewhite.sdk.Player.removePlayerListener(@NonNull [PlayerListener](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener) *playerListener*)

</ApiSignature>

删除白板回放的回调。

<ParameterList title="参数">
<Parameter name="playerListener">

白板回放的回调。详见 [`PlayerListener`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-player-listener)。

</Parameter>
</ParameterList>