feat(room): The room supports convenient broadcastRange.

Author: iohao

widget/light-client/src/main/java/com/iohao/game/external/client/AbstractInputCommandRegion.java

@@ -105,6 +105,12 @@ protected void ofListen(CallbackDelegate callback, int subCmd, String title) {
                 .setTitle(title);
     }
 
+    protected void ofListen(CallbackDelegate callback, CmdInfo cmd, String title) {
+        this.ofListen(cmd.getSubCmd())
+                .setCallback(callback)
+                .setTitle(title);
+    }
+
     private ListenCommand ofListen(int subCmd) {
         CmdInfo cmdInfo = inputCommandCreate.ofCmdInfo(subCmd);
         ListenCommand listenCommand = new ListenCommand(cmdInfo);

widget/light-game-room/pom.xml

@@ -24,7 +24,6 @@
             <groupId>com.iohao.game</groupId>
             <artifactId>light-domain-event</artifactId>
             <version>${project.parent.version}</version>
-            <scope>provided</scope>
         </dependency>
     </dependencies>
 

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/Room.java

@@ -18,6 +18,7 @@
  */
 package com.iohao.game.widget.light.room;
 
+import com.iohao.game.action.skeleton.core.CmdInfo;
 import com.iohao.game.action.skeleton.core.flow.FlowContext;
 import com.iohao.game.action.skeleton.core.flow.FlowContextKit;
 import com.iohao.game.common.kit.OperationCode;
@@ -126,7 +127,7 @@ default Map<Long, Player> getRobotMap() {
      * get 房间状态
      *
      * @return 房间状态
-     * @deprecated 没有代替，请开发者自行定义房间状态
+     * @deprecated Developers should define room states themselves.
      */
     @Deprecated
     RoomStatusEnum getRoomStatusEnum();
@@ -135,7 +136,7 @@ default Map<Long, Player> getRobotMap() {
      * set 房间状态
      *
      * @param roomStatusEnum 房间状态
-     * @deprecated 没有代替，请开发者自行定义房间状态
+     * @deprecated Developers should define room states themselves.
      */
     @Deprecated
     void setRoomStatusEnum(RoomStatusEnum roomStatusEnum);
@@ -357,7 +358,7 @@ default void removePlayer(Player player) {
      *
      * @param roomStatusEnum 房间状态
      * @return true 是所指定的房间状态
-     * @deprecated 没有代替，请开发者自行定义房间状态
+     * @deprecated Developers should define room states themselves.
      */
     @Deprecated
     default boolean isStatus(RoomStatusEnum roomStatusEnum) {
@@ -661,4 +662,55 @@ default void operation(OperationHandler operationHandler, FlowContext flowContex
                 .setCommand(commandMessage)
                 .execute();
     }
+
+    /**
+     * Broadcast data to a specific user.
+     *
+     * @param cmdInfo cmdInfo
+     * @param data    data
+     * @param userId  userId
+     * @since 21.28
+     */
+    default void broadcastToUser(CmdInfo cmdInfo, Object data, long userId) {
+        if (this.isRobot(userId)) {
+            return;
+        }
+
+        this.getAggregationContext().broadcast(cmdInfo, data, userId);
+    }
+
+    /**
+     * Broadcast data, excluding specified players.
+     *
+     * @param cmdInfo       cmdInfo
+     * @param data          data
+     * @param excludeUserId excludeUserId
+     * @since 21.28
+     */
+    default void broadcastRange(CmdInfo cmdInfo, Object data, long excludeUserId) {
+        if (this.isEmptyRealPlayer()) {
+            return;
+        }
+
+        var playerIdList = this.listRealPlayerId();
+        if (playerIdList.isEmpty()) {
+            return;
+        }
+
+        this.ofEmptyRangeBroadcast()
+                .addUserId(playerIdList, excludeUserId)
+                .setResponseMessage(cmdInfo, data)
+                .execute();
+    }
+
+    /**
+     * Broadcast data
+     *
+     * @param cmdInfo cmdInfo
+     * @param data    data
+     * @since 21.28
+     */
+    default void broadcastRange(CmdInfo cmdInfo, Object data) {
+        broadcastRange(cmdInfo, data, 0);
+    }
 }

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/RoomStatusEnum.java

@@ -24,7 +24,7 @@
  * @author 渔民小镇
  * @date 2022-03-31
  * @since 17
- * @deprecated 没有代替，请开发者自行定义房间状态
+ * @deprecated Developers should define room states themselves.
  */
 @Deprecated
 public enum RoomStatusEnum {

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/flow/GameFixedService.java

@@ -18,9 +18,6 @@
  */
 package com.iohao.game.widget.light.room.flow;
 
-import com.iohao.game.widget.light.room.Player;
-import com.iohao.game.widget.light.room.Room;
-
 /**
  * 游戏流程 - 相对固定的流程。如，创建房间、创建玩家、进入房间；解散房间、退出房间、玩家准备。
  * <pre>
@@ -37,29 +34,7 @@
  * @date 2024-05-15
  * @since 21.8
  */
-public interface GameFixedService {
-    /**
-     * 创建房间, 子类只需要关心房间配置和规则信息
-     * <pre>
-     *     延迟到子游戏中实现, 以便适应不同的子游戏规则
-     * </pre>
-     *
-     * @param createContext 创建房间信息（及玩法规则）
-     * @return 房间
-     */
-    Room createRoom(RoomCreateContext createContext);
-
-    /**
-     * 创建房间内的玩家
-     * <pre>
-     *     延迟到子游戏中实现, 以便适应不同的子游戏规则
-     * </pre>
-     *
-     * @param gameFlowContext 游戏流程上下文
-     * @return 玩家
-     */
-    Player createPlayer(GameFlowContext gameFlowContext);
-
+public interface GameFixedService extends RoomCreator, PlayerCreator {
     /**
      * 进入房间 (重连)
      *
@@ -71,6 +46,7 @@ public interface GameFixedService {
      * 解散房间
      *
      * @param gameFlowContext gameFlowContext
+     * @deprecated non
      */
     default void dissolveRoom(GameFlowContext gameFlowContext) {
     }

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/flow/GameStartService.java

@@ -40,7 +40,8 @@ public interface GameStartService {
      *
      * @param gameFlowContext 开始游戏上下文
      */
-    void startGameVerify(GameFlowContext gameFlowContext);
+    default void startGameVerify(GameFlowContext gameFlowContext) {
+    }
 
     /**
      * 游戏开始，会在 {@link GameStartService#startGameVerify(GameFlowContext)} 校验成功后执行。
@@ -51,7 +52,8 @@ public interface GameStartService {
      *
      * @param gameFlowContext 开始游戏上下文
      */
-    void startGameVerifyAfter(GameFlowContext gameFlowContext);
+    default void startGameVerifyAfter(GameFlowContext gameFlowContext) {
+    }
 
     /**
      * 执行游戏开始，内部会调用 {@link GameStartService#startGameVerify(GameFlowContext)}

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/flow/PlayerCreator.java

@@ -0,0 +1,39 @@
+/*
+ * ioGame
+ * Copyright (C) 2021 - present  渔民小镇 （[email protected]、[email protected]） . All Rights Reserved.
+ * # iohao.com . 渔民小镇
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.iohao.game.widget.light.room.flow;
+
+import com.iohao.game.widget.light.room.Player;
+
+/**
+ * @author 渔民小镇
+ * @date 2025-06-03
+ * @since 21.28
+ */
+public interface PlayerCreator {
+    /**
+     * 创建房间内的玩家
+     * <pre>
+     *     延迟到子游戏中实现, 以便适应不同的子游戏规则
+     * </pre>
+     *
+     * @param gameFlowContext 游戏流程上下文
+     * @return 玩家
+     */
+    Player createPlayer(GameFlowContext gameFlowContext);
+}

widget/light-game-room/src/main/java/com/iohao/game/widget/light/room/flow/RoomCreator.java

@@ -0,0 +1,39 @@
+/*
+ * ioGame
+ * Copyright (C) 2021 - present  渔民小镇 （[email protected]、[email protected]） . All Rights Reserved.
+ * # iohao.com . 渔民小镇
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.iohao.game.widget.light.room.flow;
+
+import com.iohao.game.widget.light.room.Room;
+
+/**
+ * @author 渔民小镇
+ * @date 2025-06-03
+ * @since 21.28
+ */
+public interface RoomCreator {
+    /**
+     * 创建房间, 子类只需要关心房间配置和规则信息
+     * <pre>
+     *     延迟到子游戏中实现, 以便适应不同的子游戏规则
+     * </pre>
+     *
+     * @param createContext 创建房间信息（及玩法规则）
+     * @return 房间
+     */
+    Room createRoom(RoomCreateContext createContext);
+}