void addBattleListener(BattleListener listener);

void removeBattleListener(BattleListener listener);

Future<BattleRequestCompletionHandler> requestBattle({
    required BattleConfig config,
    required List<String> userIDList,
    required int timeout,
});

Future<CompletionHandler> cancelBattleRequest({
    required String battleID,
    required List<String> userIDList,
});

Future<CompletionHandler> acceptBattle(String battleID);

Future<CompletionHandler> rejectBattle(String battleID);

Future<CompletionHandler> exitBattle(String battleID);

// 创建 store 实例
final store = BattleStore.create('live_room_123');

// 定义监听器
late final VoidCallback battleInfoListener = _onBattleInfoChanged;
late final VoidCallback battleUsersListener = _onBattleUsersChanged;

void _onBattleInfoChanged() {
    final battleInfo = store.battleState.currentBattleInfo.value;
    if (battleInfo != null) {
        print('当前 PK ID: ${battleInfo.battleID}');
    }
}

void _onBattleUsersChanged() {
    print('PK 用户数: ${store.battleState.battleUsers.value.length}');
}

// 订阅状态变化
store.battleState.currentBattleInfo.addListener(battleInfoListener);
store.battleState.battleUsers.addListener(battleUsersListener);

// 添加 PK 事件监听器
final battleListener = BattleListener(
    onBattleStarted: (battleInfo, inviter, invitees) {
        print('PK 开始，发起者: ${inviter.userName}');
    },
    onBattleEnded: (battleInfo, reason) {
        print('PK 结束，原因: $reason');
    },
);
store.addBattleListener(battleListener);

// 发起 PK 请求
final config = BattleConfig(duration: 300, needResponse: true);
final result = await store.requestBattle(
    config: config,
    userIDList: ['user_456'],
    timeout: 30,
);
if (result.code == 0) {
    print('PK 请求成功: ${result.battleInfo?.battleID}');
} else {
    print('PK 请求失败: ${result.message}');
}

// 取消订阅
store.battleState.currentBattleInfo.removeListener(battleInfoListener);
store.battleState.battleUsers.removeListener(battleUsersListener);
store.removeBattleListener(battleListener);