Web（浏览器） 快速开始与功能指南

pnpm add @nimeet/rtc-web

// 你的后端（Node 示例）：
// POST $NIMEET_API_BASE/v1/tokens  { channelName, uid, role, ttlSeconds }
// 前端只拿到 { appId, rtcToken, rtcUid }
const response = await fetch('/api/rtc-token?channel=weekly-sync&uid=10001');
const { appId, rtcToken, rtcUid } = await response.json();

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

const client = AgoraRTC.createClient({ mode: 'rtc', codec: 'vp8' });

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();
});
client.on('token-privilege-will-expire', async () => {
  const fresh = await fetch('/api/rtc-token?renew=1').then((r) => r.json());
  await client.renewToken(fresh.rtcToken);
});

const uid = await client.join(appId, 'weekly-sync', rtcToken, rtcUid);

const [microphoneTrack, cameraTrack] = await AgoraRTC.createMicrophoneAndCameraTracks();
cameraTrack.play('local-player');
await client.publish([microphoneTrack, cameraTrack]);

// 手动订阅（默认是自动订阅，关掉后需要自己 subscribe）
await client.unsubscribe(remoteUser, 'video');
cameraTrack.setEnabled(false); // 静音画面但保持发布

try {
  await client.publish([microphoneTrack, cameraTrack]);
} catch (error) {
  if (error.code === 'PERMISSION_DENIED') {
    // 用户拒绝了摄像头/麦克风权限
  } else if (error.code === 'NOT_SUPPORTED') {
    // 该能力在当前媒体栈未实现（例如 E2EE），不要静默忽略
  }
}

join(appid: string, channel: string, token: string|null, uid?: UID|null, options?: {autoSubscribe?:boolean;autoReceiveAndPlayAudio?:boolean;networkQualityProbe?:boolean}): Promise<UID>
leave(): Promise<void>
publish(tracks: ILocalTrack|ILocalTrack[]): Promise<void>
renewToken(token: string): Promise<void>
setClientRole(role: ClientRole, options?: ClientRoleOptions): Promise<void>
subscribe(user: IAgoraRTCRemoteUser|UID, mediaType: "video"): Promise<IRemoteVideoTrack>
createClient(config: ClientConfig): IAgoraRTCClient