快速开始

pnpm dev:api

# `pnpm dev:api` 会在服务端数据目录生成演示凭证：
cat data/demo-credentials.json

{
  "appId": "…32 位十六进制…",
  "customerId": "cid_…",
  "customerSecret": "…（只在创建时写入一次，每次重启会重新 seed 并重写本文件）",
  "appCertificate": "…（只在服务端使用）"
}

# 1) 登录控制台（演示账号见上方，可用 CONSOLE_SEED_EMAIL/PASSWORD 覆盖）
SESSION=$(curl -s -X POST https://api.your-domain.example/console/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"owner@example.com","password":"change-me-now"}' \
  | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>process.stdout.write(JSON.parse(s).token))")

# 2) 创建项目：appCertificate 与 customerSecret 只在这一次响应里返回
curl -s -X POST https://api.your-domain.example/console/projects \
  -H "Authorization: Bearer $SESSION" \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-first-project","services":{"recording":true,"streaming":true}}'

#!/usr/bin/env bash
# 签发 / 校验 / 续期 Token（等价声网 Token 服务）
# 运行前提：已执行 pnpm dev:api（演示凭证写在服务端数据目录）。
set -euo pipefail

: "${NIMEET_API_BASE:=http://127.0.0.1:8787}"
CRED_FILE=$([ -f 控制面 class="tok-flag">-credentials.json ] && echo 控制面 class="tok-flag">-credentials.json || echo data/demo-credentials.json)
CRED=$(node -e "const c=JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'));process.stdout.write(Buffer.from(c.customerId+':'+c.customerSecret).toString('base64'))" "$CRED_FILE")

# 1) 签发：host 角色，频道 weekly-sync，uid 10001
TOKEN_RESPONSE=$(curl -s -X POST "$NIMEET_API_BASE/v1/tokens" \
  -H "Authorization: Basic $CRED" \
  -H 'Content-Type: application/json' \
  -d '{"channelName":"weekly-sync","uid":10001,"role":"host","ttlSeconds":3600}')
echo "$TOKEN_RESPONSE"

# 2) 校验：channelName 会与 Token 内的频道绑定
TOKEN=$(node -e "process.stdout.write(JSON.parse(process.argv[1]).rtcToken)" "$TOKEN_RESPONSE")
curl -s -G "$NIMEET_API_BASE/v1/tokens/verify" \
  -H "Authorization: Basic $CRED" \
  --data-urlencode "token=$TOKEN" \
  --data-urlencode 'channelName=weekly-sync'

# 3) 续期：保持 channel / uid / role / 权限不变，只刷新有效期
curl -s -X POST "$NIMEET_API_BASE/v1/tokens/renew" \
  -H "Authorization: Basic $CRED" \
  -H 'Content-Type: application/json' \
  -d "{\"token\":\"$TOKEN\"}"

# 4) uid -> IM userId（部分结果语义：未知 uid 省略）
curl -s -X POST "$NIMEET_API_BASE/v1/uids:resolve" \
  -H "Authorization: Basic $CRED" \
  -H 'Content-Type: application/json' \
  -d '{"rtcUids":[10001,10002,2147483647]}'

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();

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 …