release 2.16.121

Author: aderan

CHANGELOG.md

@@ -1,4 +1,9 @@
 # 版本更新记录
+## [2.16.121] - 2026-05-19
+- `Room` 新增 `setWindowBoxState` 方法，用于设置窗口盒子状态。
+- `Room` 新增 `querySlidePageState` 方法，用于查询 Slide App 当前页码状态。
+- `SlideListener` 新增 `onSlidePageStateChanged` 回调，用于监听 Slide App 页码状态变化。
+- 新增 `SlidePageState`，用于描述 Slide App 当前页码和总页数。
 ## [2.16.120] - 2026-04-13
 - 更新 `@netless/window-manager` 至 1.0.13。
 - 更新 `white-web-sdk` 至 2.16.54。
@@ -873,4 +878,4 @@
 可以与 iOS 2.1.0，web 2.0.0 正式版互连，无法与 iOS 2.1.0 以下版本，以及 web 2.0.0-beta 开头的版本互连。
 
 >2019.06.24 前接入的客户，在升级至该版本时，请联系 SDK 团队，确认服务器指向版本。  
->更多内容，请查看 [2.0.0正式版发布](/blog/2019/06/22/release-note)
+>更多内容，请查看 [2.0.0正式版发布](/blog/2019/06/22/release-note)

README.md

@@ -42,7 +42,7 @@ add dependency of whiteboard in the **app/build.gradle** file
 ```groovy
 dependencies {
     // Get the latest version number through the release notes.
-    implementation "com.github.netless-io:whiteboard-android:2.16.120"
+    implementation "com.github.netless-io:whiteboard-android:2.16.121"
 }
 ```
 
@@ -61,4 +61,4 @@ Add the following line in the **app/proguard-rules.pro** file to prevent obfusca
 Our [change log](https://developer.netless.link/android-en/home/android-changelog) has release
 history.
 
-The latest release is available on [jitpack](https://jitpack.io/v/netless-io/whiteboard-android)
+The latest release is available on [jitpack](https://jitpack.io/v/netless-io/whiteboard-android)

README_zh_CN.md

@@ -67,7 +67,7 @@ allprojects {
 ```groovy
 dependencies {
     // 数字请根据最新版自行添加
-    implementation "com.github.netless-io:whiteboard-android:2.16.120"
+    implementation "com.github.netless-io:whiteboard-android:2.16.121"
 }
 ```
 

app/src/main/java/com/herewhite/demo/test/window/MaoCustomWindowActivity.java

@@ -18,6 +18,7 @@
 
 import com.herewhite.demo.BaseActivity;
 import com.herewhite.demo.R;
+import com.herewhite.demo.common.DemoAPI;
 import com.herewhite.sdk.AbstractRoomCallbacks;
 import com.herewhite.sdk.Room;
 import com.herewhite.sdk.RoomCallbacks;
@@ -50,8 +51,6 @@
 
 public class MaoCustomWindowActivity extends BaseActivity {
     private static final String APP_ID = "123/123";
-    private static final String ROOM_ID = "86c2dd20532c11f1a57421cb6882912c";
-    private static final String ROOM_TOKEN = "NETLESSROOM_YWs9eTBJOWsxeC1IVVo4VGh0NyZub25jZT0xNzc5MTU4NjEzNDI1MDAmcm9sZT0wJnNpZz1iZGUwN2RiMjgxYzY5Mzg4MDc5NmE1ZDZjYWIyZTgyNmQ1Y2NmNWNhYTZiMjVlNzc3Nzk5ZGM1MTUwZTY2ZjUzJnV1aWQ9ODZjMmRkMjA1MzJjMTFmMWE1NzQyMWNiNjg4MjkxMmM";
     private static final String SLIDE_PREFIX = "https://white-cover.oss-cn-hangzhou.aliyuncs.com/flat/dynamicConvert";
     private static final String SLIDE_TASK_ID = "46e8ff5db5714fec818f5594a6c55083";
     private static final int FALLBACK_PAGE_COUNT = 12;
@@ -94,7 +93,7 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
 
         setupControls();
         renderPreviewBar(pageCount);
-        joinFixedRoom();
+        setupRoom();
     }
 
     @Override
@@ -123,7 +122,30 @@ private void setupControls() {
         findViewById(R.id.nextPage).setOnClickListener(v -> dispatch(WindowDocsEvent.NextPage));
     }
 
-    private void joinFixedRoom() {
+    private void setupRoom() {
+        DemoAPI demoAPI = DemoAPI.get();
+        DemoAPI.Result result = new DemoAPI.Result() {
+            @Override
+            public void success(String uuid, String token) {
+                joinRoom(uuid, token);
+            }
+
+            @Override
+            public void fail(String message) {
+                log("create room failed: " + message);
+                showAlert("创建房间失败", message);
+            }
+        };
+
+        String uuid = demoAPI.getRoomUUID();
+        if (uuid != null && uuid.length() > 0) {
+            demoAPI.getRoomToken(uuid, result);
+        } else {
+            demoAPI.getNewRoom(result);
+        }
+    }
+
+    private void joinRoom(String uuid, String token) {
         WhiteSdkConfiguration configuration = new WhiteSdkConfiguration(APP_ID, true);
         configuration.setRegion(Region.cn);
         configuration.setUseMultiViews(true);
@@ -136,7 +158,7 @@ public void onSlidePageStateChanged(String appId, int page, int total) {
             }
         });
 
-        RoomParams params = new RoomParams(ROOM_ID, ROOM_TOKEN, deviceUserId());
+        RoomParams params = new RoomParams(uuid, token, deviceUserId());
         params.setRegion(Region.cn);
         params.setWritable(true);
         params.setWindowParams(new WindowParams()
@@ -147,7 +169,7 @@ public void onSlidePageStateChanged(String appId, int page, int total) {
             @Override
             public void then(Room joinedRoom) {
                 room = joinedRoom;
-                log("joined fixed room");
+                log("joined room: " + uuid);
                 addSlideApp();
             }
 

carrot.yml

@@ -1,4 +1,4 @@
 - name: whiteboard-bridge
   repoPath: ../whiteboard-bridge
   repoURL: 'https://github.com/netless-io/whiteboard-bridge.git'
-  commit: 096498c
+  commit: f9e18be

sdk/src/main/assets/whiteboard/096498c

@@ -0,0 +1,3 @@
+ M src/bridge/Displayer.ts
+ M src/bridge/Player.ts
+ M src/bridge/SDK.ts

sdk/src/main/assets/whiteboard/f9e18be

@@ -47,7 +47,7 @@
  * `WhiteSdk` 类。
  */
 public class WhiteSdk {
-    private final static String SDK_VERSION = "2.16.120";
+    private final static String SDK_VERSION = "2.16.121";
 
     private final static Gson gson = new Gson();
     private static AudioMixerBridge sAudioMixerBridge;