雅致（Agora）令牌在云函数中的生成与常见问题解决

{
  "name": "functions",
  "description": "Cloud Functions for Firebase",
  "scripts": {
    "serve": "firebase emulators:start --only functions",
    "shell": "firebase functions:shell",
    "start": "npm run shell",
    "deploy": "firebase deploy --only functions",
    "logs": "firebase functions:log"
  },
  "engines": {
    "node": "16"
  },
  "main": "index.js",
  "dependencies": {
    "agora-access-token": "^2.0.4",
    "firebase-functions": "^4.0.0"
  },
  "devDependencies": {
    "firebase-functions-test": "^0.2.0"
  },
  "private": true
}

const functions = require('firebase-functions');
const { RtcTokenBuilder, RtcRole } = require('agora-access-token');

// 强烈推荐使用Firebase Functions的环境变量存储敏感信息
// 在部署前，您需要通过 Firebase CLI 设置这些变量：
// firebase functions:config:set agora.app_id="YOUR_AGORA_APP_ID" agora.app_certificate="YOUR_AGORA_APP_CERTIFICATE"
const APP_ID = functions.config().agora.app_id;
const APP_CERTIFICATE = functions.config().agora.app_certificate;

// 确保APP_ID和APP_CERTIFICATE已配置
if (!APP_ID || !APP_CERTIFICATE) {
  console.error('Agora APP_ID or APP_CERTIFICATE is not configured. Please set them via `firebase functions:config:set`');
  // 可以在此处抛出错误或采取其他措施，防止函数在未配置时运行
}

exports.generateAgoraRtcToken = functions.https.onRequest((request, response) => {
  // 1. 处理CORS（跨域资源共享）
  // 如果您的前端应用与云函数部署在不同域，需要配置CORS。
  response.set('Access-Control-Allow-Origin', '*'); // 允许所有来源，生产环境应限制为特定域名
  if (request.method === 'OPTIONS') {
    // 预检请求处理
    response.set('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
    response.set('Access-Control-Allow-Headers', 'Content-Type');
    response.set('Access-Control-Max-Age', '3600');
    return response.status(204).send('');
  }

  // 2. 验证请求方法
  if (request.method !== 'POST') {
    return response.status(405).send('Method Not Allowed. Only POST requests are supported.');
  }

  // 3. 提取并验证请求体参数
  const { channelName, uid, role, expireTimestamp } = request.body;

  if (!channelName || uid === undefined || role === undefined || !expireTimestamp) {
    console.error('Missing required parameters:', { channelName, uid, role, expireTimestamp });
    return response.status(400).send('Missing required parameters: channelName, uid, role, expireTimestamp.');
  }

  // 4. 再次检查App ID和App Certificate是否已加载
  if (!APP_ID || !APP_CERTIFICATE) {
    console.error('Agora APP_ID or APP_CERTIFICATE is not configured. Cannot generate token.');
    return response.status(500).send('Server configuration error: Agora credentials missing.');
  }

  // 5. 类型转换与验证
  const numericUid = parseInt(uid);
  const numericRole = role === 0 ? RtcRole.PUBLISHER : RtcRole.SUBSCRIBER; // 确保角色是RtcRole枚举
  const numericExpireTimestamp = parseInt(expireTimestamp);

  if (isNaN(numericUid) || isNaN(numericExpireTimestamp)) {
    console.error('Invalid uid or expireTimestamp. Must be numbers.', { uid, expireTimestamp });
    return response.status(400).send('Invalid uid or expireTimestamp. Must be numbers.');
  }

  // 6. 生成Agora RTC令牌
  try {
    const token = RtcTokenBuilder.buildTokenWithUid(
      APP_ID,
      APP_CERTIFICATE,
      channelName,
      numericUid,
      numericRole,
      numericExpireTimestamp
    );
    // 7. 返回令牌
    return response.status(200).send({ token });
  } catch (error) {
    console.error('Error generating Agora token:', error);
    return response.status(500).send('Failed to generate Agora token due to an internal server error.');
  }
});

{
  "channelName": "my_video_channel",
  "uid": 12345,          // 用户的唯一ID，如果由Agora分配则为0
  "role": 0,             // 0 表示 PUBLISHER (发布者), 1 表示 SUBSCRIBER (订阅者)
  "expireTimestamp": 1735689599 // 令牌的Unix时间戳过期时间（例如，当前时间 + 3600秒）
}