快速开始

import { createApi, summarize } from './_lib.mjs';

export const meta = {
  id: '01-issue-token',
  title: '签发频道 Token',
  safe: true,
  needsApi: true,
};

/**
 * POST /v1/tokens
 * - 显式 uid + host 角色
 * - audience 角色（权限自动降为 join_channel + subscribe）
 * - wildcard Token（频道为 `*`）
 * - userId 派生 uid（同一 userId 稳定得到同一 rtcUid）
 */
export async function run(ctx) {
  const api = ctx.api;

  const host = await api('POST', '/v1/tokens', {
    body: { channelName: 'weekly-sync', uid: 10001, role: 'host', ttlSeconds: 3600 },
  });
  const audience = await api('POST', '/v1/tokens', {
    body: { channelName: 'weekly-sync', uid: 10002, role: 'audience' },
  });
  const wildcard = await api('POST', '/v1/tokens', { body: { wildcard: true, uid: 10003 } });
  const first = await api('POST', '/v1/tokens', { body: { channelName: 'weekly-sync', userId: 'user_alice' } });
  const second = await api('POST', '/v1/tokens', { body: { channelName: 'weekly-sync', userId: 'user_alice' } });

  const hostBody = host.json;
  const audienceBody = audience.json;
  const wildcardBody = wildcard.json;
  const firstBody = first.json;
  const secondBody = second.json;

  ctx.assert(hostBody.appId === ctx.credentials.appId, 'appId 应与项目 App ID 一致');
  ctx.assert(hostBody.rtcUid === 10001, '显式 uid 应被保留');
  ctx.assert(
    Array.isArray(hostBody.privileges) &&
      hostBody.privileges.includes('publish_video') &&
      hostBody.privileges.includes('join_channel'),
    'host 应包含发布权限',
  );
  ctx.assert(
    Array.isArray(audienceBody.privileges) &&
      !audienceBody.privileges.includes('publish_audio') &&
      audienceBody.privileges.includes('subscribe'),
    'audience 不应有发布权限',
  );
  ctx.assert(wildcardBody.channelName === '*', 'wildcard Token 的频道应为 *');
  ctx.assert(firstBody.rtcUid === secondBody.rtcUid, '同一 userId 的 rtcUid 应稳定');
  ctx.assert(hostBody.rtcToken.startsWith('nrt1.'), 'Token 前缀应为 nrt1.，SDK 侧必须当作不透明字符串');

  return {
    summary:
      `签发 5 个 Token；host uid=${hostBody.rtcUid} 权限=${hostBody.privileges.join(',')}；` +
      `audience 权限=${audienceBody.privileges.join(',')}；userId 派生 uid=${firstBody.rtcUid}（稳定）`,
    details: {
      host: summarize('host', {
        appId: hostBody.appId,
        channelName: hostBody.channelName,
        rtcUid: hostBody.rtcUid,
        role: hostBody.role,
        expireAt: hostBody.expireAt,
        privilegeExpireAt: hostBody.privilegeExpireAt,
      }),
      tokenPrefix: hostBody.rtcToken.slice(0, 24) + '…',
    },
  };
}

import AgoraRTC from '@nimeet/rtc-web';

// 1) 用 App ID 初始化（等价声网 AgoraRTC.createClient）
const client = AgoraRTC.createClient({ mode: 'rtc', codec: 'vp8' });

// 2) 订阅远端流：收到 user-published 后按需订阅并渲染
client.on('user-published', async (user, mediaType) => {
  await client.subscribe(user, mediaType);
  if (mediaType === 'video') user.videoTrack?.play('remote-player');
  if (mediaType === 'audio') user.audioTrack?.play();
});

// 3) 加入频道：Token 由你的后端调用 POST /v1/tokens 获得
const uid = await client.join('<你的 App ID>', 'weekly-sync', '<rtcToken>', 10001);

// 4) 采集并发布本地音视频
const [micTrack, cameraTrack] = await AgoraRTC.createMicrophoneAndCameraTracks();
cameraTrack.play('local-player');
await client.publish([micTrack, cameraTrack]);

// 5) 离开并释放采集设备
await client.leave();
micTrack.close();
cameraTrack.close();

# 仓库根目录：构建并启动全栈（首次构建需要几分钟）
docker compose -f deploy/compose.yml up -d --build

node 文档站 class="tok-flag">-all.mjs --only=0

ni-meet 文档示例运行器
  API:        https://api.your-domain.example (ni-meet-api v0.1.0, uptime 3s)
  凭证来源:   文件 data/demo-credentials.json
  模式:       仅安全示例（只读 / Token / 遥测）
  ✓ 00-health.mjs                       12ms  GET /healthz → ok · ni-meet-api v0.1.0
  ✓ 01-issue-token.mjs                  38ms  签发 5 个 Token；host uid=10001 …

Error response from daemon: failed to set up container networking:
Bind for 0.0.0.0:3478 failed: port is already allocated

lsof -nP -i :3478 -i :7880                  # macOS / Linux：看占用端口的进程
docker ps | grep -E '3478|7880'

   docker compose -f deploy/compose.yml down

     docker compose -p nimeet-b -f deploy/compose.yml up -d --build

     # deploy/compose.extra-ports.yml
     services:
       livekit:
         ports: !override
           - '17880:7880'
           - '17881:7881'
           - '51000-51100:50000-50100/udp'
           - '13478:3478/udp'
       api:
         environment:
           # 浏览器直连媒体面的地址要跟着换（页面里用它初始化 RTC）
           NIMEET_DEMO_SERVER_URL: ws://<your-host>:17880

     docker compose -f deploy/compose.yml -f deploy/compose.extra-ports.yml up -d --build