# 在线美术教学 API (/zh-CN/api-reference/online-art-teaching/android/api/correction) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 声网为在线美术场景提供明暗校正和透视校正功能,本文提供相关的 API 参考。 除了在线美术教学相关的 API,你还需要使用 RTC API 来实现实时音视频互动功能。你可以参考 [RTC API](/zh-CN/api-reference/rtc/android/rtc-api-overview) 文档来了解详细的 RTC API 用法。 :::info[信息] 明暗校正和透视校正 API 仅存在于声网为在线美术教学解决方案提供的声网 RTC 教育特殊版 SDK 中。声网官网的视频 SDK v4.x 版本尚不支持该功能。你可以[提交工单](https://ticket.shengwang.cn)联系我们获取声网 RTC 4.0.0 教育特殊版 SDK。 ::: 此外,你还可以参考如下 API 文档,在场景实现中添加相应的功能: - [RTM SDK](/zh-CN/api-reference/rtm/android/configuration),实现实时消息相关功能 - [互动白板 SDK](/zh-CN/api-reference/whiteboard/fastboard/android),实现在线课堂中的白板功能 - [云端录制](/zh-CN/api-reference/api-ref/cloud-recording/acquire),为实时音视频和互动白板提供录制功能 ## 明暗校正 [#明暗校正] ### enableBrightnessCorrection [#enablebrightnesscorrection] ```java public int enableBrightnessCorrection(boolean enable, int mode, Constants.VideoSourceType sourceType) ``` 开启或关闭本地画面明暗校正。 #### 参数 [#参数] | 参数 | 说明 | | --- | --- | | `enable` | [correction-android-html-0-1-1 details](#table-slot-correction-android-html-0-1-1) | | `mode` | [correction-android-html-0-2-1 details](#table-slot-correction-android-html-0-2-1) | | `sourceType` | [correction-android-html-0-3-1 details](#table-slot-correction-android-html-0-3-1) | **correction-android-html-0-1-1 details** 是否开启本地画面明暗校正: - `true`:开启。 - `false`:不开启。 **correction-android-html-0-2-1 details** 明暗校正模式: - `BRIGHTNESS_CORRECTION_MODE_AUTO(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `BRIGHTNESS_CORRECTION_MODE_MANUAL(1)`: 手动模式,SDK 启动亮度校正。 **correction-android-html-0-3-1 details** 视频源类型: - `VIDEO_SOURCE_CAMERA_PRIMARY(0)`:(默认)在第一个摄像头开启或关闭明暗校正。 - `VIDEO_SOURCE_CAMERA_SECONDARY(1)`:在第二个摄像头开启或关闭明暗校正。 #### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyBrightnessCorrectionToRemote [#applybrightnesscorrectiontoremote] ```java public abstract int applyBrightnessCorrectionToRemote(int uid, boolean enabled, int mode) ``` 开启远端用户画面的明暗校正。远端用户需要在 `enableVideo` 前先调用 `addExtension` 和 `enableExtension`,才能成功接收远程开启明暗校正请求。 #### 参数 [#参数-1] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启明暗校正的远端用户 ID。 | | `enabled` | [correction-android-html-1-2-1 details](#table-slot-correction-android-html-1-2-1) | | `mode` | [correction-android-html-1-3-1 details](#table-slot-correction-android-html-1-3-1) | **correction-android-html-1-2-1 details** 是否开启远端用户画面明暗校正: - `true`:开启 - `false`:不开启 **correction-android-html-1-3-1 details** 明暗校正模式: - `BRIGHTNESS_CORRECTION_MODE_AUTO(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `BRIGHTNESS_CORRECTION_MODE_MANUAL(1)`:手动模式,SDK 启动亮度校正。 #### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyBrightnessCorrectionToRemoteEx [#applybrightnesscorrectiontoremoteex] ```java public abstract int applyBrightnessCorrectionToRemoteEx(int uid, boolean enabled, int mode, RtcConnection connection) ``` (适用于多频道)开启对应 Connection 的远端用户画面的明暗校正。远端的用户需要在 `enableVideo` 前先调用 `addExtension` 和 `enableExtension` 才能成功接收远程开启明暗校正请求。 #### 参数 [#参数-2] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启明暗校正的远端用户 ID。 | | `enabled` | [correction-android-html-2-2-1 details](#table-slot-correction-android-html-2-2-1) | | `mode` | [correction-android-html-2-3-1 details](#table-slot-correction-android-html-2-3-1) | | `connection` | Connection 信息。详见 [`RtcConnection`](/zh-CN/api-reference/rtc/android/class-rtcconnection)。 | **correction-android-html-2-2-1 details** 是否开启远端用户画面明暗校正: - `true`:开启 - `false`:不开启 **correction-android-html-2-3-1 details** 明暗校正模式: - `BRIGHTNESS_CORRECTION_MODE_AUTO(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `BRIGHTNESS_CORRECTION_MODE_MANUAL(1)`:手动模式,SDK 启动亮度校正。 #### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。 ## 透视校正 [#透视校正] ### enableRemoteTrapezoidCorrection [#enableremotetrapezoidcorrection] ```java public abstract int enableRemoteTrapezoidCorrection(int uid, boolean enabled) ``` 在本地启用或关闭远端用户在本地渲染画面的透视校正。远端用户自身的本地预览不会看到透视校正效果。 #### 参数 [#参数-3] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启透视校正的远端用户 ID。 | | `enabled` | [correction-android-html-3-2-1 details](#table-slot-correction-android-html-3-2-1) | **correction-android-html-3-2-1 details** 是否开启远端画面透视校正: - `true`:开启 - `false`:不开启 #### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。 ### enableRemoteTrapezoidCorrectionEx [#enableremotetrapezoidcorrectionex] ```java public abstract int enableRemoteTrapezoidCorrectionEx(int uid, boolean enabled, RtcConnection connection) ``` (适用于多频道)在本地启用或关闭远端用户在本地渲染画面的透视校正。远端用户自身的本地预览不会看到透视校正效果。 #### 参数 [#参数-4] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启透视校正的远端用户 ID。 | | `enabled` | [correction-android-html-4-2-1 details](#table-slot-correction-android-html-4-2-1) | | `connection` | Connection 信息。详见 [`RtcConnection`](/zh-CN/api-reference/rtc/android/class-rtcconnection)。 | **correction-android-html-4-2-1 details** 是否开启远端画面透视校正: - `true`:开启 - `false`:不开启 #### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。 ### enableLocalTrapezoidCorrection [#enablelocaltrapezoidcorrection] ```java public abstract int enableLocalTrapezoidCorrection(boolean enabled, Constants.VideoSourceType sourceType) ``` 开启或关闭本地画面的透视校正。本地设置透视校正后,远端就能看到梯形校正后的画面。 #### 参数 [#参数-5] | 参数 | 说明 | | --- | --- | | `enabled` | [correction-android-html-5-1-1 details](#table-slot-correction-android-html-5-1-1) | | `sourceType` | [correction-android-html-5-2-1 details](#table-slot-correction-android-html-5-2-1) | **correction-android-html-5-1-1 details** 是否开启本地画面透视校正: - `true`:开启。 - `false`:不开启。 **correction-android-html-5-2-1 details** 视频源类型: - `VIDEO_SOURCE_CAMERA_PRIMARY(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `VIDEO_SOURCE_CAMERA_SECONDARY(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。 ### setLocalTrapezoidCorrectionOptions [#setlocaltrapezoidcorrectionoptions] ```java public abstract int setLocalTrapezoidCorrectionOptions(final TrapezoidCorrectionOptions options, Constants.VideoSourceType sourceType) ``` 配置本地透视校正选项。 #### 参数 [#参数-6] | 参数 | 说明 | | --- | --- | | `options` | 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。 | | `sourceType` | [correction-android-html-6-2-1 details](#table-slot-correction-android-html-6-2-1) | **correction-android-html-6-2-1 details** 视频源类型: - `VIDEO_SOURCE_CAMERA_PRIMARY(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `VIDEO_SOURCE_CAMERA_SECONDARY(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败。 ### getLocalTrapezoidCorrectionOptions [#getlocaltrapezoidcorrectionoptions] ```java public abstract TrapezoidCorrectionOptions getLocalTrapezoidCorrectionOptions(Constants.VideoSourceType sourceType) ``` 获取本地透视校正配置参数。 #### 参数 [#参数-7] | 参数 | 说明 | | --- | --- | | `sourceType` | [correction-android-html-7-1-1 details](#table-slot-correction-android-html-7-1-1) | **correction-android-html-7-1-1 details** 视频源类型: - `VIDEO_SOURCE_CAMERA_PRIMARY(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `VIDEO_SOURCE_CAMERA_SECONDARY(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-7] 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### setRemoteTrapezoidCorrectionOptions [#setremotetrapezoidcorrectionoptions] ```java public abstract int setRemoteTrapezoidCorrectionOptions(int uid, final TrapezoidCorrectionOptions options) ``` 配置远端透视校正选项。 #### 参数 [#参数-8] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `options` | 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。 | #### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败。 ### setRemoteTrapezoidCorrectionOptionsEx [#setremotetrapezoidcorrectionoptionsex] ```java public abstract int setRemoteTrapezoidCorrectionOptionsEx(int uid, final TrapezoidCorrectionOptions options, RtcConnection connection) ``` (适用于多频道)配置远端透视校正选项。 #### 参数 [#参数-9] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `options` | 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。 | | `connection` | Connection 信息。详见 [`RtcConnection`](/zh-CN/api-reference/rtc/android/class-rtcconnection)。 | #### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败。 ### getRemoteTrapezoidCorrectionOptions [#getremotetrapezoidcorrectionoptions] ```java public abstract TrapezoidCorrectionOptions getRemoteTrapezoidCorrectionOptions(int uid) ``` 获取远端透视校正配置参数。 #### 参数 [#参数-10] | 参数 | 说明 | | :------ | :-------------------------------------------------- | | `uid` | 远端用户 ID。 | #### 返回值 [#返回值-10] 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### getRemoteTrapezoidCorrectionOptionsEx [#getremotetrapezoidcorrectionoptionsex] ```java public abstract TrapezoidCorrectionOptions getRemoteTrapezoidCorrectionOptionsEx(int uid, RtcConnection connection) ``` (适用于多频道)获取远端透视校正配置参数。 #### 参数 [#参数-11] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `connection` | Connection 信息。详见 [`RtcConnection`](/zh-CN/api-reference/rtc/android/class-rtcconnection)。 | #### 返回值 [#返回值-11] 透视校正配置参数。详见 [`TrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/android/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### applyTrapezoidCorrectionToRemote [#applytrapezoidcorrectiontoremote] ```java public abstract int applyTrapezoidCorrectionToRemote(int uid, boolean enabled) ``` 将透视校正参数应用到远端用户在本地的预览画面。 #### 参数 [#参数-12] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `enabled` | [correction-android-html-11-2-1 details](#table-slot-correction-android-html-11-2-1) | **correction-android-html-11-2-1 details** 是否将透视校正参数应用到远端用户在本地的预览画面: - `true`:应用。 - `false`:不应用。 #### 返回值 [#返回值-12] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyTrapezoidCorrectionToRemoteEx [#applytrapezoidcorrectiontoremoteex] ```java public abstract int applyTrapezoidCorrectionToRemoteEx(int uid, boolean enabled, RtcConnection connection) ``` (适用于多频道)将透视校正参数应用到远端用户在本地的预览画面。 #### 参数 [#参数-13] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `enabled` | [correction-android-html-12-2-1 details](#table-slot-correction-android-html-12-2-1) | | `connection` | Connection 信息。详见 [`RtcConnection`](/zh-CN/api-reference/rtc/android/class-rtcconnection)。 | **correction-android-html-12-2-1 details** 是否将透视校正参数应用到远端用户在本地的预览画面: - `true`:应用。 - `false`:不应用。 #### 返回值 [#返回值-13] - 0:方法调用成功。 - < 0:方法调用失败。 ### onTrapezoidAutoCorrectionFinished [#ontrapezoidautocorrectionfinished] ```java public void onTrapezoidAutoCorrectionFinished( int uid, int result, int costTime, PointF[] dragSrcPoints, PointF[] dragDstPoints) {} ``` 自动透视校正完成时触发。 #### 参数 [#参数-14] | 参数 | 说明 | | --- | --- | | `uid` | 开启自动透视校正的远端用户 ID。 | | `result` | [correction-android-html-13-2-1 details](#table-slot-correction-android-html-13-2-1) | | `costTime` | 透视校正花费的时间 (ms)。 | | `dragSrcPoints` | 拖动起始点时的梯形四个顶点坐标。 | | `dragDstPoints` | 拖动结束点时的梯形四个顶点坐标。 | **correction-android-html-13-2-1 details** 自动透视校正结果: - `RESULT_OK(0)`:成功。 - `RESULT_FAILED(-1)`:失败。 ## 数据类型 [#数据类型] ### TrapezoidCorrectionOptions [#trapezoidcorrectionoptions] ```java public class TrapezoidCorrectionOptions { private PointF dragSrcPoint; private PointF dragDstPoint; private Integer dragFinished; private Integer assistLine; private Integer autoCorrect; private Integer mirror; private Integer resetDragPoints; private List dragSrcPoints; private List dragDstPoints; @CalledByNative public TrapezoidCorrectionOptions() { } @CalledByNative public PointF makePointF(float x, float y) { return new PointF(x, y); } @CalledByNative public void setDragSrcPoint(PointF pt) { dragSrcPoint = pt; } @CalledByNative public void setDragDstPoint(PointF pt) { dragDstPoint = pt; } @CalledByNative public void setDragFinished(int finished) { dragFinished = finished; } @CalledByNative public void showAssistLine(int show) { assistLine = show; } @CalledByNative public void setAutoCorrect(int autoCorr) { autoCorrect = autoCorr; } @CalledByNative public void setMirror(int mirr) { mirror = mirr; } @CalledByNative public void setResetDragPoints(int reset) { resetDragPoints = reset; } @CalledByNative public void setDragSrcPoints( PointF topLeft, PointF bottomLeft, PointF topRight, PointF bottomRight) { if (dragSrcPoints == null) dragSrcPoints = new ArrayList<>(); dragSrcPoints.clear(); dragSrcPoints.add(topLeft.x); dragSrcPoints.add(topLeft.y); dragSrcPoints.add(bottomLeft.x); dragSrcPoints.add(bottomLeft.y); dragSrcPoints.add(topRight.x); dragSrcPoints.add(topRight.y); dragSrcPoints.add(bottomRight.x); dragSrcPoints.add(bottomRight.y); } @CalledByNative public void setDragDstPoints( PointF topLeft, PointF bottomLeft, PointF topRight, PointF bottomRight) { if (dragDstPoints == null) dragDstPoints = new ArrayList<>(); dragDstPoints.clear(); dragDstPoints.add(topLeft.x); dragDstPoints.add(topLeft.y); dragDstPoints.add(bottomLeft.x); dragDstPoints.add(bottomLeft.y); dragDstPoints.add(topRight.x); dragDstPoints.add(topRight.y); dragDstPoints.add(bottomRight.x); dragDstPoints.add(bottomRight.y); } @CalledByNative public final float[] getDragSrcPoint() { return dragSrcPoint != null ? new float[] {dragSrcPoint.x, dragSrcPoint.y} : null; } @CalledByNative public final float[] getDragDstPoint() { return dragDstPoint != null ? new float[] {dragDstPoint.x, dragDstPoint.y} : null; } @CalledByNative public final Integer getDragFinished() { return dragFinished; } @CalledByNative public final Integer getAssistLine() { return assistLine; } @CalledByNative public final Integer getAutoCorrect() { return autoCorrect; } @CalledByNative public final Integer getMirror() { return mirror; } @CalledByNative public final Integer getResetDragPoints() { return resetDragPoints; } private float[] listToArray(List list) { float[] ret = new float[list.size()]; int i = 0; for (Float f : list) { ret[i++] = f; } return ret; } @CalledByNative public final float[] getDragSrcPoints() { return dragSrcPoints == null ? null : listToArray(dragSrcPoints); } @CalledByNative public final float[] getDragDstPoints() { return dragDstPoints == null ? null : listToArray(dragDstPoints); } @Override public String toString() { StringBuilder sb = new StringBuilder(); if (dragSrcPoint != null) { sb.append("dragSrcPoint : "); sb.append("x " + dragSrcPoint.x + " y " + dragSrcPoint.y); } if (dragDstPoint != null) { sb.append("dragDstPoint : "); sb.append("x " + dragDstPoint.x + " y " + dragDstPoint.y); } if (dragSrcPoints != null) { sb.append("dragSrcPoints : "); sb.append(dragSrcPoints.toString()); } if (dragDstPoints != null) { sb.append("dragDstPoints : "); sb.append(dragDstPoints.toString()); } return sb.toString(); } } ``` 透视校正参数配置,包含以下成员: #### PointF [#pointf] - `x`:x 坐标,根据屏幕宽度归一化为 [0.0~1.0] 的浮点数。 - `y`:y 坐标,根据屏幕高度归一化为 [0.0~1.0] 的浮点数。 #### setDragSrcPoint [#setdragsrcpoint] 设置拖动起始点坐标。 | 参数 | 说明 | | :--- | :--------------------------- | | pt | 拖动起始点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | #### setDragDstPoint [#setdragdstpoint] 设置拖动终止点坐标。 如果同时调用 `setDragSrcPoint`、`setDragDstPoint`、`setDragFinished` 和 `setDragSrcPoints`、`setDragDstPoints`,则 `setDragSrcPoints`、`setDragDstPoints` 的设置生效。 | 参数 | 说明 | | :--- | :--------------------------- | | pt | 拖动终止点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | #### setDragFinished [#setdragfinished] 设置该次拖动调整是否结束。 | 参数 | 说明 | | --- | --- | | `finished` | [correction-android-html-14-1-1 details](#table-slot-correction-android-html-14-1-1) | **correction-android-html-14-1-1 details** 本次拖动调整是否结束: - `0`:未结束。 - `1`:已结束。 #### setDragSrcPoints [#setdragsrcpoints] 同时设置 4 个点的拖动起始点坐标。 | 参数 | 说明 | | :---------- | :--------------------------------- | | `topLeft` | 左上角拖动起始点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `bottomLeft` | 左下角拖动起始点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `topRight` | 右上角拖动起始点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `bottomRight` | 右下角拖动起始点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | #### setDragDstPoints [#setdragdstpoints] 同时设置 4 个点的拖动终止点坐标。 | 参数 | 说明 | | :---------- | :--------------------------------- | | `topLeft` | 左上角拖动终止点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `bottomLeft` | 左下角拖动终止点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `topRight` | 右上角拖动终止点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | | `bottomRight` | 右下角拖动终止点坐标。详见 [`PointF`](/zh-CN/api-reference/online-art-teaching/android/api/correction#pointf)。 | #### showAssistLine [#showassistline] 开启或关闭辅助线。初始值为关闭。 | 参数 | 说明 | | --- | --- | | `show` | [correction-android-html-15-1-1 details](#table-slot-correction-android-html-15-1-1) | **correction-android-html-15-1-1 details** 开启或关闭辅助线: - `0`:关闭。 - `1`:开启。 #### setAutoCorrect [#setautocorrect] 开启或关闭自动透视校正。初始值为关闭。 | 参数 | 说明 | | --- | --- | | `autoCorr` | [correction-android-html-16-1-1 details](#table-slot-correction-android-html-16-1-1) | **correction-android-html-16-1-1 details** 开启或关闭自动透视校正: - `0`:关闭。关闭之后,你需要手动设置拖动点坐标。 - `1`:开启。开启之后,SDK 会自动进行透视校正。你无法手动设置拖动点坐标。 #### setMirror [#setmirror] 启用或关闭镜像。初始值为关闭。 只有使用自定义渲染功能并且自定义渲染开启水平镜像时,才需要启用镜像参数。 | 参数 | 说明 | | --- | --- | | `mirr` | [correction-android-html-17-1-1 details](#table-slot-correction-android-html-17-1-1) | **correction-android-html-17-1-1 details** 开启或关闭镜像: - `0`:关闭。 - `1`:开启。设置输入的点坐标与实际输入图像是水平镜像。 #### setResetDragPoints [#setresetdragpoints] 重置透视校正效果。初始值为不重置。 | 参数 | 说明 | | --- | --- | | `reset` | [correction-android-html-18-1-1 details](#table-slot-correction-android-html-18-1-1) | **correction-android-html-18-1-1 details** 是否重置透视校正效果: - `0`:不重置透视校正效果。 - `1`:重置透视校正效果。重置后,画面恢复为校正前的效果。