# 在线美术教学 API (/zh-CN/api-reference/online-art-teaching/macos/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/macos/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/ios/configuration),实现实时消息相关功能 - [云端录制](/zh-CN/api-reference/api-ref/cloud-recording/acquire),为实时音视频和互动白板提供录制功能 ## 明暗校正 [#明暗校正] ### enableBrightnessCorrection [#enablebrightnesscorrection] ```objc - (int)enableBrightnessCorrection:(BOOL)enabled mode:(AgoraBrightnessCorrectionMode)mode sourceType:(AgoraVideoSourceType)sourceType; ``` 开启或关闭本地画面明暗校正。 #### 参数 [#参数] | 参数 | 说明 | | --- | --- | | `enabled` | [correction-ios-macos-html-0-1-1 details](#table-slot-correction-ios-macos-html-0-1-1) | | `mode` | [correction-ios-macos-html-0-2-1 details](#table-slot-correction-ios-macos-html-0-2-1) | | `sourceType` | [correction-ios-macos-html-0-3-1 details](#table-slot-correction-ios-macos-html-0-3-1) | **correction-ios-macos-html-0-1-1 details** 是否开启本地画面明暗校正: - `YES`:开启。 - `NO`:不开启。 **correction-ios-macos-html-0-2-1 details** 明暗校正模式: - `AgoraBrightnessCorrectionModeAuto(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `AgoraBrightnessCorrectionModeManual(1)`: 手动模式,SDK 启动亮度校正。 **correction-ios-macos-html-0-3-1 details** 视频源类型: - `AgoraVideoSourceTypeCamera(0)`:(默认)在第一个摄像头开启或关闭明暗校正。 - `AgoraVideoSourceTypeCameraSecondary(1)`:在第二个摄像头开启或关闭明暗校正。 #### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyBrightnessCorrectionToRemote [#applybrightnesscorrectiontoremote] ```objc - (int)applyBrightnessCorrectionToRemote:(NSUInteger)uid enable:(BOOL)enabled mode:(AgoraBrightnessCorrectionMode)mode; ``` 开启远端用户画面的明暗校正。远端用户需要在 `enableVideo` 前先调用 `addExtension` 和 `enableExtensionWithVendor`,才能成功接收远程开启明暗校正请求。 #### 参数 [#参数-1] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启明暗校正的远端用户 ID。 | | `enabled` | [correction-ios-macos-html-1-2-1 details](#table-slot-correction-ios-macos-html-1-2-1) | | `mode` | [correction-ios-macos-html-1-3-1 details](#table-slot-correction-ios-macos-html-1-3-1) | **correction-ios-macos-html-1-2-1 details** 是否开启远端用户画面明暗校正: - `YES`:开启 - `NO`:不开启 **correction-ios-macos-html-1-3-1 details** 明暗校正模式: - `AgoraBrightnessCorrectionModeAuto(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `AgoraBrightnessCorrectionModeManual(1)`:手动模式,SDK 启动亮度校正。 #### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyBrightnessCorrectionToRemoteEx [#applybrightnesscorrectiontoremoteex] ```objc - (int)applyBrightnessCorrectionToRemoteEx:(NSUInteger)uid enable:(BOOL)enabled mode:(AgoraBrightnessCorrectionMode)mode connection:(AgoraRtcConnection * _Nonnull)connection; ``` (适用于多频道)开启对应 Connection 的远端用户画面的明暗校正。远端的用户需要在 `enableVideo` 前先调用 `addExtension` 和 `enableExtensionWithVendor` 才能成功接收远程开启明暗校正请求。 #### 参数 [#参数-2] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启明暗校正的远端用户 ID。 | | `enabled` | [correction-ios-macos-html-2-2-1 details](#table-slot-correction-ios-macos-html-2-2-1) | | `mode` | [correction-ios-macos-html-2-3-1 details](#table-slot-correction-ios-macos-html-2-3-1) | | `connection` | Connection 信息。详见 [`AgoraRtcConnection`](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。 | **correction-ios-macos-html-2-2-1 details** 是否开启远端用户画面明暗校正: - `YES`:开启 - `NO`:不开启 **correction-ios-macos-html-2-3-1 details** 明暗校正模式: - `AgoraBrightnessCorrectionModeAuto(0)`:自动模式,SDK 自动检测亮度,如果检测当前亮度正常,不会启动亮度校正。 - `AgoraBrightnessCorrectionModeManual(1)`:手动模式,SDK 启动亮度校正。 #### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。 ## 透视校正 [#透视校正] ### enableRemoteTrapezoidCorrection [#enableremotetrapezoidcorrection] ```objc - (int)enableRemoteTrapezoidCorrection:(NSUInteger)uid enable:(BOOL)enabled; ``` 在本地启用或关闭远端用户在本地渲染画面的透视校正。远端用户自身的本地预览不会看到透视校正效果。 #### 参数 [#参数-3] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启透视校正的远端用户 ID。 | | `enabled` | [correction-ios-macos-html-3-2-1 details](#table-slot-correction-ios-macos-html-3-2-1) | **correction-ios-macos-html-3-2-1 details** 是否开启远端画面透视校正: - `YES`:开启 - `NO`:不开启 #### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。 ### enableRemoteTrapezoidCorrectionEx [#enableremotetrapezoidcorrectionex] ```objc - (int)enableRemoteTrapezoidCorrectionEx:(NSUInteger)uid enable:(BOOL)enabled connection:(AgoraRtcConnection * _Nonnull)connection; ``` (适用于多频道)在本地启用或关闭远端用户在本地渲染画面的透视校正。远端用户自身的本地预览不会看到透视校正效果。 #### 参数 [#参数-4] | 参数 | 说明 | | --- | --- | | `uid` | 需要开启透视校正的远端用户 ID。 | | `enabled` | [correction-ios-macos-html-4-2-1 details](#table-slot-correction-ios-macos-html-4-2-1) | | `connection` | Connection 信息。详见 [`AgoraRtcConnection`](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。 | **correction-ios-macos-html-4-2-1 details** 是否开启远端画面透视校正: - `YES`:开启 - `NO`:不开启 #### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。 ### enableLocalTrapezoidCorrection [#enablelocaltrapezoidcorrection] ```objc - (int)enableLocalTrapezoidCorrection:(BOOL)enabled sourceType:(AgoraVideoSourceType)sourceType; ``` 开启或关闭本地画面的透视校正。本地设置透视校正后,远端就能看到梯形校正后的画面。 #### 参数 [#参数-5] | 参数 | 说明 | | --- | --- | | `enabled` | [correction-ios-macos-html-5-1-1 details](#table-slot-correction-ios-macos-html-5-1-1) | | `sourceType` | [correction-ios-macos-html-5-2-1 details](#table-slot-correction-ios-macos-html-5-2-1) | **correction-ios-macos-html-5-1-1 details** 是否开启本地画面透视校正: - `YES`:开启。 - `NO`:不开启。 **correction-ios-macos-html-5-2-1 details** 视频源类型: - `AgoraVideoSourceTypeCamera(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `AgoraVideoSourceTypeCameraSecondary(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。 ### setLocalTrapezoidCorrectionOptions [#setlocaltrapezoidcorrectionoptions] ```objc - (int)setLocalTrapezoidCorrectionOptions:(AgoraTrapezoidCorrectionOptions * _Nonnull)options sourceType:(AgoraVideoSourceType)sourceType; ``` 配置本地透视校正选项。 #### 参数 [#参数-6] | 参数 | 说明 | | --- | --- | | `options` | 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。 | | `sourceType` | [correction-ios-macos-html-6-2-1 details](#table-slot-correction-ios-macos-html-6-2-1) | **correction-ios-macos-html-6-2-1 details** 视频源类型: - `AgoraVideoSourceTypeCamera(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `AgoraVideoSourceTypeCameraSecondary(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败。 ### getLocalTrapezoidCorrectionOptions [#getlocaltrapezoidcorrectionoptions] ```objc - (AgoraTrapezoidCorrectionOptions *_Nullable)getLocalTrapezoidCorrectionOptions:(AgoraVideoSourceType)sourceType; ``` 获取本地透视校正配置参数。 #### 参数 [#参数-7] | 参数 | 说明 | | --- | --- | | `sourceType` | [correction-ios-macos-html-7-1-1 details](#table-slot-correction-ios-macos-html-7-1-1) | **correction-ios-macos-html-7-1-1 details** 视频源类型: - `AgoraVideoSourceTypeCamera(0)`:(默认)在第一个摄像头开启或关闭透视校正。 - `AgoraVideoSourceTypeCameraSecondary(1)`:在第二个摄像头开启或关闭透视校正。 #### 返回值 [#返回值-7] 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### setRemoteTrapezoidCorrectionOptions [#setremotetrapezoidcorrectionoptions] ```objc - (int)setRemoteTrapezoidCorrection:(NSUInteger)uid options:(AgoraTrapezoidCorrectionOptions * _Nonnull)options; ``` 配置远端透视校正选项。 #### 参数 [#参数-8] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `options` | 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。 | #### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败。 ### setRemoteTrapezoidCorrectionOptionsEx [#setremotetrapezoidcorrectionoptionsex] ```objc - (int)setRemoteTrapezoidCorrectionEx:(NSUInteger)uid options:(AgoraTrapezoidCorrectionOptions * _Nonnull)options connection:(AgoraRtcConnection * _Nonnull)connection; ``` (适用于多频道)配置远端透视校正选项。 #### 参数 [#参数-9] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `options` | 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。 | | `connection` | Connection 信息。详见 [`AgoraRtcConnection`](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。 | #### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败。 ### getRemoteTrapezoidCorrectionOptions [#getremotetrapezoidcorrectionoptions] ```objc - (AgoraTrapezoidCorrectionOptions *_Nullable)getRemoteTrapezoidCorrectionOptions:(NSUInteger)uid; ``` 获取远端透视校正配置参数。 #### 参数 [#参数-10] | 参数 | 说明 | | :------ | :-------------------------------------------------- | | `uid` | 远端用户 ID。 | #### 返回值 [#返回值-10] 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### getRemoteTrapezoidCorrectionOptionsEx [#getremotetrapezoidcorrectionoptionsex] ```objc - (AgoraTrapezoidCorrectionOptions *_Nullable)getRemoteTrapezoidCorrectionOptionsEx:(NSUInteger)uid connection:(AgoraRtcConnection * _Nonnull)connection; ``` (适用于多频道)获取远端透视校正配置参数。 #### 参数 [#参数-11] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `connection` | Connection 信息。详见 [`AgoraRtcConnection`](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。 | #### 返回值 [#返回值-11] 透视校正配置参数。详见 [`AgoraTrapezoidCorrectionOptions`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#trapezoidcorrectionoptions)。如果之前多次设置过透视校正参数,则获取的是之前多次设置的参数集合。 ### applyTrapezoidCorrectionToRemote [#applytrapezoidcorrectiontoremote] ```objc - (int)applyTrapezoidCorrectionToRemote:(NSUInteger)uid enable:(BOOL)enabled; ``` 将透视校正参数应用到远端用户在本地的预览画面。 #### 参数 [#参数-12] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `enabled` | [correction-ios-macos-html-11-2-1 details](#table-slot-correction-ios-macos-html-11-2-1) | **correction-ios-macos-html-11-2-1 details** 是否将透视校正参数应用到远端用户在本地的预览画面: - `YES`:应用。 - `NO`:不应用。 #### 返回值 [#返回值-12] - 0:方法调用成功。 - < 0:方法调用失败。 ### applyTrapezoidCorrectionToRemoteEx [#applytrapezoidcorrectiontoremoteex] ```objc - (int)applyTrapezoidCorrectionToRemoteEx:(NSUInteger)uid enable:(BOOL)enabled connection:(AgoraRtcConnection * _Nonnull)connection; ``` (适用于多频道)将透视校正参数应用到远端用户在本地的预览画面。 #### 参数 [#参数-13] | 参数 | 说明 | | --- | --- | | `uid` | 远端用户 ID。 | | `enabled` | [correction-ios-macos-html-12-2-1 details](#table-slot-correction-ios-macos-html-12-2-1) | | `connection` | Connection 信息。详见 [`AgoraRtcConnection`](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。 | **correction-ios-macos-html-12-2-1 details** 是否将透视校正参数应用到远端用户在本地的预览画面: - `YES`:应用。 - `NO`:不应用。 #### 返回值 [#返回值-13] - 0:方法调用成功。 - < 0:方法调用失败。 ### trapezoidAutoCorrectionFinish [#trapezoidautocorrectionfinish] ```objc - (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine trapezoidAutoCorrectionFinish:(NSUInteger)uid result:(AgoraTrapezoidAutoCorrectionResult)result costTime:(NSUInteger)costTime srcPoints:(NSArray * _Nonnull)srcPoints dstPoints:(NSArray * _Nonnull)dstPoints; ``` 自动透视校正完成时触发。 #### 参数 [#参数-14] | 参数 | 说明 | | --- | --- | | `uid` | 开启自动透视校正的远端用户 ID。 | | `result` | [correction-ios-macos-html-13-2-1 details](#table-slot-correction-ios-macos-html-13-2-1) | | `costTime` | 透视校正花费的时间 (ms)。 | | `srcPoints` | 拖动起始点时的梯形四个顶点坐标。 | | `dstPoints` | 拖动结束点时的梯形四个顶点坐标。 | **correction-ios-macos-html-13-2-1 details** 自动透视校正结果: - `RESULT_OK(0)`:成功。 - `RESULT_FAILED(-1)`:失败。 ## 数据类型 [#数据类型] ### TrapezoidCorrectionOptions [#trapezoidcorrectionoptions] ```objc struct TrapezoidCorrectionOptions { enum { POINT_ARRAY_LEN = 8, }; struct Point { float x; // value in [0.0 - 1.0] float y; // value in [0.0 - 1.0] }; TrapezoidCorrectionOptions():hasMultiPoints(false){} void setDragSrcPoint(Point pt) { dragSrcPoint = pt; } void setDragDstPoint(Point pt) { dragDstPoint = pt; } void setDragFinished(int finished) { dragFinished = finished; } void setDragSrcPoints(Point topLeft, Point bottomLeft, Point topRight, Point bottomRight) { dragSrcPoints[0] = topLeft.x; dragSrcPoints[1] = topLeft.y; dragSrcPoints[2] = bottomLeft.x; dragSrcPoints[3] = bottomLeft.y; dragSrcPoints[4] = topRight.x; dragSrcPoints[5] = topRight.y; dragSrcPoints[6] = bottomRight.x; dragSrcPoints[7] = bottomRight.y; hasMultiPoints = true; } void setDragDstPoints(Point topLeft, Point bottomLeft, Point topRight, Point bottomRight) { dragDstPoints[0] = topLeft.x; dragDstPoints[1] = topLeft.y; dragDstPoints[2] = bottomLeft.x; dragDstPoints[3] = bottomLeft.y; dragDstPoints[4] = topRight.x; dragDstPoints[5] = topRight.y; dragDstPoints[6] = bottomRight.x; dragDstPoints[7] = bottomRight.y; hasMultiPoints = true; } void showAssistLine(int show) { assistLine = show; } void setAutoCorrect(int autoCorr) { autoCorrect = autoCorr; } void setMirror(int mirr) { mirror = mirr; } void setResetDragPoints(int reset) { resetDragPoints = reset; } Optional dragSrcPoint; Optional dragDstPoint; Optional dragFinished; //value: 0 or 1 float dragSrcPoints[POINT_ARRAY_LEN]; float dragDstPoints[POINT_ARRAY_LEN]; bool hasMultiPoints; // if true, indicates dragSrcPoints and dragDstPoints have valid values Optional assistLine; //value: 0 or 1 Optional autoCorrect; //value: 0 or 1 Optional mirror; //value: 0 or 1, only set if not use sdk renderer, such as custom renderer Optional resetDragPoints; //value: 0 or 1 }; ``` 透视校正参数配置,包含以下成员: #### Point [#point] - `x`:x 坐标,根据屏幕宽度归一化为 [0.0~1.0] 的浮点数。 - `y`:y 坐标,根据屏幕高度归一化为 [0.0~1.0] 的浮点数。 #### setDragSrcPoint [#setdragsrcpoint] 设置拖动起始点坐标。 | 参数 | 说明 | | :--- | :--------------------------- | | `pt` | 拖动起始点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | #### setDragDstPoint [#setdragdstpoint] 设置拖动终止点坐标。 如果同时调用 `setDragSrcPoint`、`setDragDstPoint`、`setDragFinished` 和 `setDragSrcPoints`、`setDragDstPoints`,则 `setDragSrcPoints`、`setDragDstPoints` 的设置生效。 | 参数 | 说明 | | :--- | :--------------------------- | | `pt` | 拖动终止点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | #### setDragFinished [#setdragfinished] 设置该次拖动调整是否结束。 | 参数 | 说明 | | --- | --- | | `finished` | [correction-ios-macos-html-14-1-1 details](#table-slot-correction-ios-macos-html-14-1-1) | **correction-ios-macos-html-14-1-1 details** 本次拖动调整是否结束: - `0`:未结束。 - `1`:已结束。 #### setDragSrcPoints [#setdragsrcpoints] 同时设置 4 个点的拖动起始点坐标。 | 参数 | 说明 | | :---------- | :--------------------------------- | | `topLeft` | 左上角拖动起始点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `bottomLeft` | 左下角拖动起始点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `topRight` | 右上角拖动起始点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `bottomRight` | 右下角拖动起始点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | #### setDragDstPoints [#setdragdstpoints] 同时设置 4 个点的拖动终止点坐标。 | 参数 | 说明 | | :---------- | :--------------------------------- | | `topLeft` | 左上角拖动终止点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `bottomLeft` | 左下角拖动终止点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `topRight` | 右上角拖动终止点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | | `bottomRight` | 右下角拖动终止点坐标。详见 [`Point`](/zh-CN/api-reference/online-art-teaching/macos/api/correction#point)。 | #### showAssistLine [#showassistline] 开启或关闭辅助线。初始值为关闭。 | 参数 | 说明 | | --- | --- | | `show` | [correction-ios-macos-html-15-1-1 details](#table-slot-correction-ios-macos-html-15-1-1) | **correction-ios-macos-html-15-1-1 details** 开启或关闭辅助线: - `0`:关闭。 - `1`:开启。 #### setAutoCorrect [#setautocorrect] 开启或关闭自动透视校正。初始值为关闭。 | 参数 | 说明 | | --- | --- | | `autoCorr` | [correction-ios-macos-html-16-1-1 details](#table-slot-correction-ios-macos-html-16-1-1) | **correction-ios-macos-html-16-1-1 details** 开启或关闭自动透视校正: - `0`:关闭。关闭之后,你需要手动设置拖动点坐标。 - `1`:开启。开启之后,SDK 会自动进行透视校正。你无法手动设置拖动点坐标。 #### setMirror [#setmirror] 启用或关闭镜像。初始值为关闭。 只有使用自定义渲染功能并且自定义渲染开启水平镜像时,才需要启用镜像参数。 | 参数 | 说明 | | --- | --- | | `mirr` | [correction-ios-macos-html-17-1-1 details](#table-slot-correction-ios-macos-html-17-1-1) | **correction-ios-macos-html-17-1-1 details** 开启或关闭镜像: - `0`:关闭。 - `1`:开启。设置输入的点坐标与实际输入图像是水平镜像。 #### setResetDragPoints [#setresetdragpoints] 重置透视校正效果。初始值为不重置。 | 参数 | 说明 | | --- | --- | | `reset` | [correction-ios-macos-html-18-1-1 details](#table-slot-correction-ios-macos-html-18-1-1) | **correction-ios-macos-html-18-1-1 details** 是否重置透视校正效果: - `0`:不重置透视校正效果。 - `1`:重置透视校正效果。重置后,画面恢复为校正前的效果。