diff --git a/Android--CN/sdk/AudioMixerBridge.java b/Android--CN/sdk/AudioMixerBridge.java index d97ce0c..47b6aa6 100644 --- a/Android--CN/sdk/AudioMixerBridge.java +++ b/Android--CN/sdk/AudioMixerBridge.java @@ -12,7 +12,7 @@ * 为解决上述问题,你可以使用 `AudioMixerBridge` 接口,以调用 RTC SDK 的混音方法播放动态 PPT 中的音频文件。 * * @note - * 仅当用户使用的 RTC SDK 支持混音方法时,该方法才会生效。 + * 仅当用户使用的 RTC SDK 支持混音方法时,该接口的方法才会生效。//TODO WJ 这个支持是指 SDK 版本要求吗?RTC SDK 很早就支持混音了吧 */ public interface AudioMixerBridge { /** @@ -24,10 +24,10 @@ public interface AudioMixerBridge { * - `true`:只有本地可以听到混音的音频流。 * - `false`:本地和对方都可以听到混音的音频流。 * @param replace 是否播放麦克风采集的音频: - * - `true`: 只播音频文件,不播麦克风采集的音频。 - * - `false`: 将音频文件和麦克风采集的音频混音。 + * - `true`: 只播放音频文件,不播放麦克风采集的音频。 + * - `false`: 将音频文件和麦克风采集的音频混音后播放。 * @param cycle 音频文件循环播放的次数: - * - 正整数:循环的次数。 + * - 正整数:循环的次数。//TODO WJ 这里的描述要跟着 RTC 修改,主要是 0 的问题。 * - -1:无限循环。 void startAudioMixing(String filepath, boolean loopback, boolean replace, int cycle); diff --git a/Android--CN/sdk/AudioMixerImplement.java b/Android--CN/sdk/AudioMixerImplement.java index 105baeb..7320939 100644 --- a/Android--CN/sdk/AudioMixerImplement.java +++ b/Android--CN/sdk/AudioMixerImplement.java @@ -22,7 +22,7 @@ public class AudioMixerImplement { * PPT 根据收到的音频播放状态判断是否显示画面,以确保音画同步。 * * @note - * 如果 RTC SDK 没有混音状态回调方法,会导致播放的 PPT音画不同步。 + * 如果 RTC SDK 没有混音状态回调方法,会导致播放的 PPT 音画不同步。//TODO WJ 什么叫 SDK 没有混音状态回调方法? * * @param state 音乐文件播放状态: * - MEDIA_ENGINE_AUDIO_EVENT_MIXING_PLAY(710): RTC SDK 成功调用 `startAudioMixing` 播放音乐文件或 `resumeAudioMixing` 恢复播放音乐文件。 diff --git a/Android--CN/sdk/CommonCallbacks.java b/Android--CN/sdk/CommonCallbacks.java index 302f747..c88158e 100644 --- a/Android--CN/sdk/CommonCallbacks.java +++ b/Android--CN/sdk/CommonCallbacks.java @@ -15,7 +15,7 @@ public interface CommonCallbacks { /** * SDK 出现未捕获的全局错误回调。 - * @param args + * @param args //TODO WJ 缺注释 */ void throwError(Object args); @@ -30,7 +30,7 @@ public interface CommonCallbacks { * @note * 由于该回调过于频繁,Agora 不推荐使用;在 Android 平台,可以使用 WebView 的拦截功能进行图片拦截。 * - * @param sourceUrl 图片原地址。 + * @param sourceUrl 图片源地址。 * @return 替换后的图片地址。 */ String urlInterrupter(String sourceUrl); @@ -53,7 +53,7 @@ public interface CommonCallbacks { * * @since 2.11.4 * - * 当本地用户收到了网页,如 iframe 插件,动态 PPT 发送的消息时会触发该回调。 + * 当本地用户收到了网页(如 iframe 插件、动态 PPT)发送的消息时会触发该回调。 * * @note * 不保证所有用户都能接收到该回调。 @@ -67,8 +67,8 @@ public interface CommonCallbacks { * * @since 2.9.14 * - * 如果 SDK 初始化失败,调用加入实时房间或回放房间时会处于一直无响应状态,需要重新初始化 SDK。 - * - 初始化 SDK 时候,网络异常,导致获取配置信息失败。 + * 如果 SDK 初始化失败,调用加入实时房间或回放房间的方法时会处于一直无响应状态,需要重新初始化 SDK。 + * - 初始化 SDK 时候,网络异常,导致获取配置信息失败。//TODO WJ 这里是列了两个可能的失败原因?需要在前面加一些文字连起来。 * - 传入了不合法的 App Identifier。 * @since 2.9.14 */ diff --git a/Android--CN/sdk/Displayer.java b/Android--CN/sdk/Displayer.java index d301fe3..c8edfc1 100644 --- a/Android--CN/sdk/Displayer.java +++ b/Android--CN/sdk/Displayer.java @@ -48,11 +48,11 @@ public class Displayer { protected ConcurrentHashMap frequencyEventListenerConcurrentHashMap = new ConcurrentHashMap<>(); /** - * Displayer 类的构造函数。 - * @param uuid 用户 ID。 + * Displayer 类的构造函数。 //TODO WJ SDK 内部调用的,可以不暴露在文档里 + * @param uuid 白板房间的 UUID。 * @param bridge 白板界面,详见 {@link WhiteboardView}。 * @param context Android 的 Context。 - * @param sdk White SDK 的初始化设置,详见 {@link WhiteSdk}。 + * @param sdk 白板 SDK 的初始化设置,详见 {@link WhiteSdk}。 */ public Displayer(String uuid, WhiteboardView bridge, Context context, WhiteSdk sdk) { this.uuid = uuid; @@ -73,10 +73,10 @@ public void postIframeMessage(String string) { /** * 向 iframe 插件发送 key-value 格式的信息。 * - * 你可以通过创建 WhiteObject 的子类来创建一个 ley-value 格式的信息。 + * 你可以通过创建 WhiteObject 的子类来创建一个 key-value 格式的信息。 * * @param object `Whiteobject` 的子类,详见 {@link WhiteObject}。 - * @since 2.11.4 + * @since 2.11.4 //TODO WJ 版本信息的 tag 位置要放到描述开头。 */ public void postIframeMessage(WhiteObject object) { bridge.callHandler("displayer.postMessage", new Object[]{object}); @@ -85,9 +85,9 @@ public void postIframeMessage(WhiteObject object) { /** * 查询场景路径类型。 * - * 你可以在该方法中指定想要查询的场景路径,SDK 会返回该路径对应的场景类型,是场景,还是场景目录,或者不存在任何内容。 - * @param path 想要查询的场景类型。 - * @param promise `Promise` 接口实例,详见 {@link WhiteScenePathTType}。你可以通过该接口获取查询场景路径类型的结果: + * 你可以在该方法中指定想要查询的场景路径,SDK 会返回该路径对应的场景类型。 + * @param path 想要查询的场景路径。 + * @param promise `Promise` 接口实例,详见 {@link WhiteScenePathType}。你可以通过该接口获取查询场景路径类型的结果: * - 如果查询成功,将返回场景路径类型。 * - 如果查询失败,将返回错误信息。 */ @@ -130,7 +130,7 @@ public void refreshViewSize() { } /** - * 以连续动画的形式等比例缩放 PPT。 + * 以连续动画的形式等比例缩放视角,以保证完整显示 PPT 的内容。//TODO WJ 这里的连续动画是指渐变模式吗?如果是的话,建议统一用词 * * 该方法用于确保 PPT 页面的所有内容都在视野范围内。 * @since 2.4.22 @@ -140,11 +140,11 @@ public void scalePptToFit() { } /** - * 等比例缩放 PPT。 + * 等比例缩放视角,以保证完整显示 PPT 的内容。 * * 该方法用于确保 PPT 页面的内容都在视野内。 * - * @param mode PPT 缩放时的动画行为,详见 {@link AnimationMode}。 + * @param mode PPT 缩放时的动画模式,详见 {@link AnimationMode}。 * @since 2.4.28 */ public void scalePptToFit(AnimationMode mode) { @@ -158,7 +158,7 @@ public void scalePptToFit(AnimationMode mode) { * @note 对于同名的自定义事件,SDK 仅支持触发一个回调。 * * @param eventName 想要监听的自定义事件名称。 - * @param eventListener 自定义事件回调,详见 {@link EventListener}。如果添加多个事件回调,则之前添加的回调会被覆盖。 + * @param eventListener 自定义事件回调,详见 {@link EventListener}。如果添加多个事件回调,则之前添加的回调会被覆盖。//TODO WJ 这里说的添加多个事件回调是指多个同名的事件回调吗? */ public void addMagixEventListener(String eventName, EventListener eventListener) { this.eventListenerConcurrentHashMap.put(eventName, eventListener); @@ -171,8 +171,8 @@ public void addMagixEventListener(String eventName, EventListener eventListener) * @note 对于同名的自定义事件,SDK 仅支持触发一个回调。 * * @param eventName 想要监听的自定义事件名称。 - * @param eventListener 自定义事件回调,详见 {@link FrequencyEventListener}。如果添加多个事件回调,则之前添加的回调会被覆盖。 - * @param fireInterval SDK 触发回调的频率,单位为毫秒。该参数最小值为 500ms;低于该值会被传入重置为 500ms。 + * @param eventListener 自定义事件回调,详见 {@link FrequencyEventListener}。如果添加多个事件回调,则之前添加的回调会被覆盖。//TODO WJ 这里说的添加多个事件回调是指多个同名的事件回调吗? + * @param fireInterval SDK 触发回调的频率,单位为毫秒。该参数最小值为 500 ms,如果设置为低于该值会被重置为 500 ms。 */ public void addHighFrequencyEventListener(String eventName, FrequencyEventListener eventListener, Integer fireInterval) { if (fireInterval < 500) { @@ -267,7 +267,7 @@ private static Float[] hexSplit(@ColorInt int color) { * * @since 2.4.0 * - * @return 本地白板的背景色。,格式为 16 进制 ARGB 定义下的 Hex 值。 + * @return 本地白板的背景色,格式为 16 进制 ARGB 定义下的 Hex 值。 */ public int getBackgroundColor() { return backgroundColor; @@ -281,7 +281,7 @@ public int getBackgroundColor() { * @param scenePath 指定的场景路径。 * @param promise `Promise` 接口实例,详见 {@link Promise}。你可以通过该接口了解获取场景预览图的结果: * - 如果获取成功,将返回获取的预览图。 - * - 如果获取失败,将反馈错误码。 + * - 如果获取失败,将返回错误码。 * @since 2.3.0 */ public void getScenePreviewImage(String scenePath, final Promisepromise) { @@ -304,7 +304,7 @@ public void onValue(String retValue) { /** * 获取特定场景的截图。 * - * 该方法可用于实现用户切换到对应场景时,能立刻看到该场景内容的功能。 + * 该方法可用于实现用户切换到对应场景时,能立刻看到该场景内容的功能。//TODO WJ 这句话是不是应该删掉,怎么和预览的功能一模一样 * * @param scenePath 指定的场景路径。 * @param promise `Promise` 接口实例,详见 {@link Promise}。你可以通过该接口了解获取场景截图的结果: @@ -338,13 +338,13 @@ private Bitmap transformBase64toBitmap(String base64String) { } /** - * 禁止/允许用户移动视角。 + * 禁止/允许用户缩放白板视野。 * - * 移动视角是指用户可以通过触屏手势放大或缩小白板视野。 + * 该方法可以设置是否允许用户通过触屏手势放大或缩小白板视野。 * - * @param disable 是否禁止用户移动视角: - * - true: 禁止用户移动视角。 - * - false: (默认) 允许用户移动视角。 + * @param disable 是否禁止用户缩放白板视野: + * - true: 禁止用户缩放白板视野。 + * - false: (默认) 允许用户缩放白板视野。 * @since 2.11.0 */ public void disableCameraTransform(Boolean disable) { @@ -352,11 +352,11 @@ public void disableCameraTransform(Boolean disable) { } /** - * 移动视角。 + * 移动白板视野。 * - * 该方法可用于实现用户通过触屏手势对白板视野进行缩放操作的功能。 + * 该方法可用于实现用户通过触屏手势对白板视野进行缩放和移动操作的功能。//TODO WJ 缩放功能是不是要求 disableCameraTrannsform 设置为 true? * - * @param camera 移动视角的具体参数配置,详见 {@link CameraConfig}。 + * @param camera 白板视野的具体参数配置,详见 {@link CameraConfig}。 * @since 2.2.0 */ public void moveCamera(CameraConfig camera) { @@ -364,7 +364,7 @@ public void moveCamera(CameraConfig camera) { } /** - * 调整用户视野。 + * 调整用户视野。//TODO WJ 这个方法的描述是不是应该提到视觉矩形? * * @param rectangle 能表示用户视野的视觉矩形设置,详见 {@link RectangleConfig}。 * @since 2.2.0 diff --git a/Android--CN/sdk/Player.java b/Android--CN/sdk/Player.java index 43e25fd..4b5bbf1 100644 --- a/Android--CN/sdk/Player.java +++ b/Android--CN/sdk/Player.java @@ -45,7 +45,7 @@ public double getPlaybackSpeed() { /** * 设置白板回放的倍速。 * - * @param playbackSpeed 白板回放的倍速。取值必须大于 0,设为 1 表示按原速播放。 + * @param playbackSpeed 白板回放的倍速。取值必须大于 0,设为 1 表示按原速播放。//TODO WJ 这个取值没有上限吗? * * @since 2.5.2 */ @@ -139,9 +139,9 @@ public void stop() { /** * 设置白板回放的开始时间。 * - * 由于 SDK 会录制实时房间的全部过程,因此默认情况下,回放会播放从房间构造开始直到最后一次活跃结束的全部过程。 + * 由于 SDK 会录制实时房间的全部过程,因此默认情况下,回放会播放从房间构造开始直到最后一次活跃结束的全部过程。//TODO WJ 最后一次活跃? * 因此在进行回放时,需要调用该方法设置开始回放的时间点。 - * @param seekTime 白板回放的开始时间,单位为毫秒。 + * @param seekTime 白板回放的开始时间,单位为毫秒。//TODO WJ 这个是 UTC 时间吗? */ public void seekToScheduleTime(long seekTime) { bridge.callHandler("player.seekToScheduleTime", new Object[]{seekTime}); @@ -186,7 +186,7 @@ public void setObserverMode(PlayerObserverMode mode) { //region Get API /** - * 获取白板回放房间的阶段。该方法为同步调用。 + * 获取白板回放房间的阶段。该方法为同步调用。//TODO WJ 上面几个方法都是“白板回放”,这里是“白板回放房间”,下面又变成“回放房间”,不知道是不是一回事。 * * 在 Player 生命周期内,你可以调用该方法获取当前回放房间的阶段。其中初始阶段为 `waitingFirstFrame`,表示正在等待白板回放的第一帧。 * @@ -206,7 +206,7 @@ public PlayerPhase getPlayerPhase() { * * @note * - 成功调用 {@link #stop()}、{@link #play()}、{@link #pause()} 等方法均会影响回放房间的阶段,但是该阶段不会立即更新。 - * - 该方位为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 {@link #getPlayerPhase()} 进行获取。 + * - 该方位为异步调用。我们推荐你仅在调试或问题排查时使用。一般情况下可以使用同步方法 {@link #getPlayerPhase()} 获取回放阶段。 * * @param promise `Promise` 接口实例,详见 {@link Promise 类}。你可以通过该接口了解获取白板回放阶段的结果: * - 如果获取成功,将返回白板回放的阶段。 @@ -234,7 +234,7 @@ public void onValue(Object o) { /** * 获取回放房间的状态。该方法为同步调用。 * - * 如果回放房间的状态 Player phase 为 `waitingFirstFrame`,则该方法返回 Null。 + * 如果回放房间的状态为 `waitingFirstFrame`,则该方法返回 `null`。 * * @return 回放房间状态,详见 {@link PlayerState}。 * @since 2.4.0 @@ -278,7 +278,7 @@ public void onValue(Object o) { /** * 获取白板回放的时间信息,该方法为同步调用。 * - * 该方法获取的时间信息,包含当前的播放时间,回放文件的总时长,以及开始播放的 UTC 时间戳,单位为毫秒。 + * 该方法获取的时间信息,包含当前的播放时间,回放文件的总时长,以及开始播放的 UTC 时间戳,单位为毫秒。//TODO WJ 当前的播放时间是指当前播放到哪里了? * * @note 该方法获取的当前播放时间可能不准确。 * diff --git a/Android--CN/sdk/PlayerEventListener.java b/Android--CN/sdk/PlayerEventListener.java index dc0cea4..f094752 100644 --- a/Android--CN/sdk/PlayerEventListener.java +++ b/Android--CN/sdk/PlayerEventListener.java @@ -5,45 +5,45 @@ import com.herewhite.sdk.domain.SDKError; /** - * 回放房间事件回调接口 + * 回放房间的事件回调接口。 */ public interface PlayerEventListener { /** - * 播放状态切换回调 + * 播放状态切换回调。 */ void onPhaseChanged(PlayerPhase phase); /** - * 首帧加载回调 + * 首帧加载回调。 */ void onLoadFirstFrame(); /** - * 分片切换回调,需要了解分片机制。目前无实际用途 + * 分片切换回调,需要了解分片机制。目前无实际用途。//TODO WJ 这个要放到文档里吗? */ void onSliceChanged(String slice); /** - * 播放中,状态出现变化的回调,只会包含实际发生改变的属性 + * 回放状态发生变化的回调,只会包含实际发生改变的属性。 */ void onPlayerStateChanged(PlayerState modifyState); /** - * 出错暂停 + * 出错导致回放暂停的回调。 */ void onStoppedWithError(SDKError error); /** - * 进度时间变化 + * 进度时间变化 //TODO WJ 这个是什么意思? */ void onScheduleTimeChanged(long time); /** - * 添加帧出错 + * 添加帧出错的回调。 */ void onCatchErrorWhenAppendFrame(SDKError error); /** - * 渲染时,出错 + * 渲染时出错的回调。 */ void onCatchErrorWhenRender(SDKError error); } diff --git a/Android--CN/sdk/domain/Appliance.java b/Android--CN/sdk/domain/Appliance.java index 1d9aaa1..b9125a9 100644 --- a/Android--CN/sdk/domain/Appliance.java +++ b/Android--CN/sdk/domain/Appliance.java @@ -6,24 +6,24 @@ /** 教具名称。 */ public class Appliance { - /** 铅笔 */ + /** 铅笔。 */ public final static String PENCIL = "pencil"; - /** 选择工具 */ + /** 选择工具。 */ public final static String SELECTOR = "selector"; - /** 矩形工具 */ + /** 矩形工具。 */ public final static String RECTANGLE = "rectangle"; - /** 椭圆工具 */ + /** 椭圆工具。 */ public final static String ELLIPSE = "ellipse"; - /** 橡皮工具 */ + /** 橡皮工具。 */ public final static String ERASER = "eraser"; - /** 文本输入框 */ + /** 文本输入框。 */ public final static String TEXT = "text"; - /** 直线工具 */ + /** 直线工具。 */ public final static String STRAIGHT = "straight"; - /** 箭头工具 */ + /** 箭头工具。 */ public final static String ARROW = "arrow"; - /** 抓手工具 */ + /** 抓手工具。 */ public final static String HAND = "hand"; - /** 激光笔 */ + /** 激光笔。 */ public final static String LASER_POINTER = "laserPointer"; } diff --git a/Android--CN/sdk/domain/CameraBound.java b/Android--CN/sdk/domain/CameraBound.java index 57c278a..7816809 100644 --- a/Android--CN/sdk/domain/CameraBound.java +++ b/Android--CN/sdk/domain/CameraBound.java @@ -8,7 +8,7 @@ public class CameraBound extends WhiteObject { /** - * 获取用户视野范围的原点在世界坐标系的 x 轴坐标。 + * 获取用户视野范围的原点在世界坐标系的 x 轴坐标。//TODO WJ X 轴,X 大写,需要统一改 * * 世界坐标系指白板内部坐标系,即以白板初始化时的中心点为原点的坐标系。 * @@ -76,7 +76,7 @@ public Double getHeight() { * 设置用户视野范围的高度。 * * 该方法可以搭配 {@link #setMinContentMode(ContentModeConfig)} 或 {@link #setMaxContentMode(ContentModeConfig)} 使用, - * 用来限制用户视野的最小或最大缩放比例。 + * 用来限制用户视野的最小或最大缩放比例。//TODO WJ 应该是用来限制用户视野范围的边界? * * @param height 用户视野范围的高度。如果不设,则表示视野宽度无限制。 */ @@ -136,7 +136,7 @@ public Double getDamping() { * 设置用户将视野移出视野范围边界时感受到的阻力。 * * 该方法仅在用户使用手指触碰方式移动视野时生效。 - * 设置为 `0.0` 的时候,可以缩放,但是手松开的时候,视野会弹回去;设置为 `1.0`,完全不能将视野移动超过边界。 + * 设置为 `0.0` 的时候,可以缩放,但是手松开的时候,视野会弹回去;设置为 `1.0`,完全不能将视野移动超过边界。//TODO WJ 这里的描述就是参数下面的描述,重复了。 * * @param damping 阻力大小,取值范围为 [0.0,1.0]。取值越大,用户感受到的阻力越大。 * - 0.0: 设置为 0 时,表示视野缩放完全无阻力;当用户手指离开屏幕时,视野会恢复。 diff --git a/Android--CN/sdk/domain/CameraConfig.java b/Android--CN/sdk/domain/CameraConfig.java index e04543f..0c134d6 100644 --- a/Android--CN/sdk/domain/CameraConfig.java +++ b/Android--CN/sdk/domain/CameraConfig.java @@ -1,7 +1,7 @@ package com.herewhite.sdk.domain; /** - * 视野范围配置类。 + * 白板的视野配置。 * * @since 2.2.0 */ diff --git a/Android--CN/sdk/domain/MemberState.java b/Android--CN/sdk/domain/MemberState.java index 8075b5a..330873f 100644 --- a/Android--CN/sdk/domain/MemberState.java +++ b/Android--CN/sdk/domain/MemberState.java @@ -27,7 +27,7 @@ public String getCurrentApplianceName() { /** * 设置互动白板实时房间内使用的教具。 * - * @param 教具名称,详见 {@link Appliance Appliance}。 + * @param currentApplianceName 教具名称,详见 {@link Appliance Appliance}。 */ public void setCurrentApplianceName(String currentApplianceName) { this.currentApplianceName = currentApplianceName; @@ -36,7 +36,7 @@ public void setCurrentApplianceName(String currentApplianceName) { /** * 获取用户设置的线条颜色。 * - * @return 线条颜色,为 RGB 格式,例如,[0, 0, 255] 表示蓝色。 + * @return 线条颜色,为 RGB 格式,例如,[0, 0, 255] 表示蓝色。//TODO WJ rgb 格式的写法好像应该是 (0,0,255) */ public int[] getStrokeColor() { return strokeColor; @@ -45,7 +45,7 @@ public int[] getStrokeColor() { /** * 设置线条颜色。 * - * @param 线条颜色,为 RGB 格式,例如,[0, 0, 255] 表示蓝色。 + * @param strokeColor 线条颜色,为 RGB 格式,例如,[0, 0, 255] 表示蓝色。 */ public void setStrokeColor(int[] strokeColor) { this.strokeColor = strokeColor; @@ -64,7 +64,7 @@ public double getStrokeWidth() { /** * 设置线条粗细。 * - * @param strokeWidth 线条粗细。 + * @param strokeWidth 线条粗细。//TODO WJ 单位是啥? */ public void setStrokeWidth(double strokeWidth) { this.strokeWidth = strokeWidth; @@ -83,7 +83,7 @@ public double getTextSize() { /** * 设置字体大小。 * - * @param textSize 字体大小。Chrome 浏览器对于小于 12 的字体会自动调整为 12。 + * @param textSize 字体大小。Chrome 浏览器对于小于 12 的字体会自动调整为 12。//TODO WJ 单位是 pt 吗? */ public void setTextSize(double textSize) { this.textSize = textSize; diff --git a/Android--CN/sdk/domain/PlayerConfiguration.java b/Android--CN/sdk/domain/PlayerConfiguration.java index aaa4d25..b156f8b 100644 --- a/Android--CN/sdk/domain/PlayerConfiguration.java +++ b/Android--CN/sdk/domain/PlayerConfiguration.java @@ -16,8 +16,8 @@ public Region getRegion() { } /** - * 类似 {@link com.herewhite.sdk.RoomParams#setRegion(Region)} - * @param region + * 类似 {@link com.herewhite.sdk.RoomParams#setRegion(Region)} //TODO WJ 类似???需要更具体的描述。 + * @param region //TODO WJ 缺注释 */ public void setRegion(Region region) { this.region = region; @@ -26,7 +26,7 @@ public void setRegion(Region region) { private Region region; /** - * player 初始化方法 + * player 初始化方法 //TODO WJ 这是 SDK 内部调用的吗? * @param room 需要回放的房间 uuid * @param roomToken 房间 roomToken */ @@ -35,11 +35,12 @@ public PlayerConfiguration(String room, String roomToken) { this.roomToken = roomToken; } + //TODO WJ 这个方法不需要注释? public CameraBound getCameraBound() { return cameraBound; } - /** + /** //TODO WJ 缺注释 * {@link com.herewhite.sdk.Room#setCameraBound(CameraBound)} * @param cameraBound */ @@ -48,7 +49,7 @@ public void setCameraBound(CameraBound cameraBound) { } /** - * 回放时,时间进度的调用频率 + * 回放时,时间进度的调用频率 //TODO WJ 什么意思? * // TODO WL 什么叫时间进度的调用频率?调用的是什么? * @param duration 时长长度 * @param timeUnit 时间单位 @@ -92,25 +93,26 @@ public void setSlice(String slice) { this.slice = slice; } + //TODO WJ 这个不需要注释? public Long getBeginTimestamp() { return beginTimestamp; } - /*** - * 回放房间的起始 UTC 时间戳(毫秒) // TODO 是标准的 Unix 时间戳吗? - * 比如,想要回放 Wed Mar 10 2021 18:03:34 GMT+0800 (中国标准时间) 的话,需要传入 1615370614269 - * @param beginTimestamp //TODO 缺少参数解释 + /** + * 设置回放的起始时间。// TODO 是标准的 Unix 时间戳吗? + * @param beginTimestamp 回放房间的起始 UTC 时间戳(毫秒)。例如,想要回放 Wed Mar 10 2021 18:03:34 GMT+0800 (中国标准时间) 的话,需要传入 1615370614269。 */ public void setBeginTimestamp(Long beginTimestamp) { this.beginTimestamp = beginTimestamp; } + //TODO WJ 缺注释 public Long getDuration() { return duration; } /** - * 设置持续时长(毫秒) + * 设置持续时长(毫秒)//TODO WJ 设置什么的时长?参数缺注释。下面的方法都不需要注释? * @param duration // TODO WL 缺少参数解释 */ public void setDuration(Long duration) { diff --git a/Android--CN/sdk/domain/PlayerObserverMode.java b/Android--CN/sdk/domain/PlayerObserverMode.java index 12a847f..9429cc4 100644 --- a/Android--CN/sdk/domain/PlayerObserverMode.java +++ b/Android--CN/sdk/domain/PlayerObserverMode.java @@ -11,7 +11,7 @@ public enum PlayerObserverMode { directory, /** - * 自由模式。 + * 自由模式。//TODO WJ 自由模式啥意思? */ freedom } diff --git a/Android--CN/sdk/domain/PlayerPhase.java b/Android--CN/sdk/domain/PlayerPhase.java index 72ce619..fb99759 100644 --- a/Android--CN/sdk/domain/PlayerPhase.java +++ b/Android--CN/sdk/domain/PlayerPhase.java @@ -3,7 +3,7 @@ import com.google.gson.annotations.SerializedName; /** - * 白板回放房间的阶段。 + * 白板回放的阶段。 */ public enum PlayerPhase { /** @@ -18,17 +18,17 @@ public enum PlayerPhase { * 白板回放已暂停。 */ pause, - @SerializedName("stop") /** * 白板回放已停止。 */ + @SerializedName("stop") stopped, /** * 白板回放已结束。 */ ended, /** - * 白板回放正在缓存中。 + * 白板回放正在缓存。 */ buffering, } diff --git a/Android--CN/sdk/domain/PlayerTimeInfo.java b/Android--CN/sdk/domain/PlayerTimeInfo.java index b70eef1..fb2b8e5 100644 --- a/Android--CN/sdk/domain/PlayerTimeInfo.java +++ b/Android--CN/sdk/domain/PlayerTimeInfo.java @@ -19,7 +19,7 @@ public PlayerTimeInfo(long scheduleTime, long timeDuration, int framesCount, lon } /** - * 当前时间进度(毫秒)。// TODO 已播放时长? + * 当前时间进度(毫秒)。//TODO WJ 当前播放进度?已播放时长? */ public long getScheduleTime() { return scheduleTime; @@ -39,7 +39,7 @@ public int getFramesCount() { } /** - * 开始时间,UTC 时间戳(毫秒)。// TODO Unix 时间戳? + * 开始时间,UTC 时间戳(毫秒)。//TODO WJ 开始回放的时间?Unix 时间戳? */ public long getBeginTimestamp() { return beginTimestamp; diff --git a/Android--CN/sdk/domain/PptPage.java b/Android--CN/sdk/domain/PptPage.java index 7f331a4..fed4b62 100644 --- a/Android--CN/sdk/domain/PptPage.java +++ b/Android--CN/sdk/domain/PptPage.java @@ -17,7 +17,7 @@ public class PptPage extends WhiteObject { private Double height; /** - * `PptPage` 构造方法,用于创建背景图实例。 + * `PptPage` 构造方法,用于创建背景图实例。//TODO WJ 这个是开发者要调用的? * * 该方法只能在场景初始化的时候调用。 * @@ -43,7 +43,7 @@ public String getSrc() { } /** - * 设置背景图的 URL 地址。 + * 设置背景图的 URL 地址。 //TODO WJ 这个方法应该是通过设置 URL 指定背景图吧? * * @param src 背景图的 URL 地址。 */ diff --git a/Android--CN/sdk/domain/RectangleConfig.java b/Android--CN/sdk/domain/RectangleConfig.java index ea0e577..6f7e693 100644 --- a/Android--CN/sdk/domain/RectangleConfig.java +++ b/Android--CN/sdk/domain/RectangleConfig.java @@ -3,7 +3,7 @@ /** * `RectangleConfig` 类。该类配置白板的视觉矩形。 * 通过视觉矩形,你可以设置视野范围内需要关注的内容。 - * 该方法可用于保证同样的内容在不同的设备上都可以显示完整。 + * 该方法可用于保证同样的内容在不同的设备上都可以显示完整。//TODO WJ 这里的描述是不是应该放到设置视觉矩形的方法里? * * @since 2.2.0 */ @@ -14,7 +14,7 @@ public class RectangleConfig extends WhiteObject { private Double height; /** - * `RectangleConfig` 构造函数。 + * `RectangleConfig` 构造函数。//TODO WJ 这几个 RectangleConfig 构造函数是对外的吗?这几个方法里的参数都可以通过下面提供的方法进行设置 * * 在该函数中,你需要传入 `width`,`height` 和 `mode`。SDK 会根据你传入 `width` 和 `height` 计算视觉矩形左上角原点 * 在世界坐标系中的位置 `originX` 和 `originY`, 即 `originX = - width / 2.0d`,`originY = - height / 2.0d`。 @@ -23,7 +23,7 @@ public class RectangleConfig extends WhiteObject { * * @param width 白板视觉矩形的宽度。视觉矩形的宽度不能小于实际展示内容的宽度,否则用户将看不见超出的部分。 * @param height 白板视觉矩形的高度。视觉矩形的高度不能小于实际展示内容的宽度,否则用户将看不见超出的部分。 - * @param mode 白板的动画模式,详见 {@link AnimationMode}。 + * @param mode 白板视觉矩形的动画模式,详见 {@link AnimationMode}。 */ public RectangleConfig(Double width, Double height, AnimationMode mode) { this.width = width; @@ -39,7 +39,7 @@ public RectangleConfig(Double width, Double height, AnimationMode mode) { * 在该函数中,你需要传入 `width` 和 `height`。SDK 会根据你传入 `width` 和 `height` 计算视觉矩形左上角原点 * 在世界坐标系中的位置 `originX` 和 `originY`, 即 `originX = - width / 2.0d`,`originY = - height / 2.0d`。 * - * 该方法不支持设置动画模式,SDK 会默认将动画模式设置为 `Continuous`。 + * 该方法不支持设置动画模式,SDK 会默认将动画模式设置为 `Continuous`,即连续动画模式。 * * 该方法适用于需要快速显示完整 PPT 内容的场景。 * diff --git a/Android--CN/sdk/domain/WhiteDisplayerState.java b/Android--CN/sdk/domain/WhiteDisplayerState.java index 57580cb..617f92c 100644 --- a/Android--CN/sdk/domain/WhiteDisplayerState.java +++ b/Android--CN/sdk/domain/WhiteDisplayerState.java @@ -31,7 +31,7 @@ public static void setCustomGlobalStateClass(Class cl } /** - * 全局状态,所有用户可见,实时房间时,可读可写;回放房间只读。返回内容为 sdk 默认全局状态 + * 全局状态,所有用户可见,实时房间时,可读可写;回放房间只读。返回内容为 sdk 默认全局状态 //TODO WJ 这里的描述需要确认 * * @return 全局状态 */ @@ -51,20 +51,18 @@ public GlobalState getGlobalState() { } /** - * 获取房间中所有用户列表 + * 获取房间中所有的用户。 * - * @return 用户成员状态列表 [ ] - * @see RoomMember + * @return 用户成员列表,详见 {@link RoomMember}。 */ public RoomMember[] getRoomMembers() { return roomMembers; } /** - * 获取当前场景目录下的场景状态 + * 获取当前场景目录下的场景状态。 * - * @return 当前场景目录下的场景状态 - * @see SceneState + * @return 当前场景目录下的场景状态,详见 {@link SceneState}。 */ public SceneState getSceneState() { return sceneState; diff --git a/Android--CN/sdk/domain/WhiteScenePathType.java b/Android--CN/sdk/domain/WhiteScenePathType.java index 387bc32..8baaa1e 100644 --- a/Android--CN/sdk/domain/WhiteScenePathType.java +++ b/Android--CN/sdk/domain/WhiteScenePathType.java @@ -3,7 +3,7 @@ import com.google.gson.annotations.SerializedName; /** - * 路径类型。 + * 白板场景的路径类型。 * * @since 2.6.4 */