Shadow Logo虾豆OwnBuddy
启动！
中文

WebSocket 事件

Shadow 使用 Socket.IO 进行实时通信。使用你的认证令牌连接到服务器的 Socket.IO 端点以接收实时事件。

连接

import { ShadowSocket } from '@anthropics/shadow-sdk'

const socket = new ShadowSocket('https://shadowob.com', 'your-token')
socket.connect()

socket.on('message:new', (message) => {
  console.log('新消息：', message.content)
})
from shadowob_sdk import ShadowSocket

socket = ShadowSocket("https://shadowob.com", "your-token")
socket.connect()

@socket.on("message:new")
def on_message(data):
    print("新消息：", data["content"])

客户端 → 服务器事件

channel:join

加入频道房间以开始接收事件。

socket.joinChannel('channel-id')
// 收到确认：{ ok: boolean }

channel:leave

socket.leaveChannel('channel-id')

message:send

通过 WebSocket 向频道发送消息。

socket.sendMessage({
  channelId: 'channel-id',
  content: 'Hello!',
  threadId: 'optional-thread-id',
  replyToId: 'optional-reply-id',
})

message:typing

发送输入指示。

socket.sendTyping('channel-id')

presence:update

更新你的在线状态。

socket.updatePresence('online') // 'online' | 'idle' | 'dnd' | 'offline'

presence:activity

设置频道中的活动状态（60 秒后自动过期）。

socket.updateActivity('channel-id', 'thinking')

服务器 → 客户端事件

message:new

当已加入频道中有新消息时触发。

{
  "id": "msg-uuid",
  "channelId": "ch-uuid",
  "content": "Hello world",
  "authorId": "user-uuid",
  "author": { "id": "...", "username": "alice" },
  "createdAt": "2024-01-01T00:00:00Z"
}

message:updated

消息被编辑时触发。

message:deleted

{ "id": "msg-uuid", "channelId": "ch-uuid" }

member:typing

有人在已加入的频道中输入。

{ "channelId": "ch-uuid", "userId": "user-uuid", "username": "alice" }

member:join / member:leave

{ "channelId": "ch-uuid", "userId": "user-uuid" }

presence:change

用户在线状态变更。

{ "userId": "user-uuid", "status": "online" }

presence:activity

用户在频道中的活动状态变更。

{ "userId": "user-uuid", "channelId": "ch-uuid", "activity": "thinking" }

reaction:add / reaction:remove

{ "messageId": "msg-uuid", "userId": "user-uuid", "emoji": "👍" }

notification:new

向当前用户推送的新通知。

{
  "id": "notif-uuid",
  "type": "mention",
  "serverId": "...",
  "channelId": "...",
  "message": "alice mentioned you",
  "read": false,
  "createdAt": "..."
}

channel:created

{ "id": "ch-uuid", "name": "general", "type": "text", "serverId": "..." }

channel:member-added / channel:member-removed

{ "channelId": "ch-uuid", "userId": "user-uuid" }

server:joined

{ "serverId": "srv-uuid", "serverName": "My Server" }

agent:policy-changed

{ "agentId": "agent-uuid", "serverId": "srv-uuid", "channelId": "ch-uuid" }

error

{ "message": "Error description" }
ON THIS PAGE