Nakama Taro Client

这是 Nakama 服务器的 Taro 框架适配版本，支持小程序、H5 和 React Native 等多端环境。

特性

• 🚀 支持 Taro 多端环境（微信小程序、支付宝小程序、H5、React Native 等）
• 🔌 使用 Taro.connectSocket 进行 WebSocket 连接
• 🌐 使用 Taro.request 进行 HTTP 请求
• 📦 完整的 TypeScript 类型支持
• 🔄 与原版 nakama-js API 完全兼容

安装

npm install   nakama-taro

使用示例

基础配置

import { Client } from 'nakama-taro';

const client = new Client({
  serverKey: "defaultkey",
  host: "127.0.0.1",
  port: "7350",
  ssl: false
});

用户认证

// 邮箱密码登录
const session = await client.authenticateEmail("[email protected]", "password");

// 设备ID登录
const session = await client.authenticateDevice("unique-device-id");

WebSocket 连接

import { DefaultTaroWebSocketAdapter } from 'nakama-taro';

const socket = client.createSocket(session, false, new DefaultTaroWebSocketAdapter());
await socket.connect();

实时功能

// 聊天消息
socket.onChannelMessage = (message) => {
  console.log('收到消息:', message);
};

// 加入聊天频道
const channel = await socket.joinChat("chat-room", 1);

// 发送消息
await socket.writeChatMessage(channel.id, { message: "Hello World!" });

主要改动

WebSocket 适配

• 使用 Taro.connectSocket 替代原生 WebSocket
• 支持 Taro 的多端环境（小程序、H5、RN）
• 自动处理二进制数据和文本数据

HTTP 请求适配

• 使用 Taro.request 替代 fetch API
• 兼容 Taro 的请求格式和响应处理
• 支持多端网络请求

环境兼容性

• ✅ 微信小程序
• ✅ 支付宝小程序
• ✅ H5
• ✅ React Native
• ✅ 百度小程序
• ✅ 字节跳动小程序

构建和开发

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

许可证

Apache License 2.0

相关链接

• Nakama 官方文档
• Taro 官方文档
• 原版 nakama-js