Agora 云函数生成 Token 教程：解决常见参数错误

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

// 强烈建议将 App ID 和 App Certificate 存储在环境变量中，而不是硬编码
// 例如：firebase functions:config:set agora.appid="YOUR_APP_ID" agora.appcertificate="YOUR_APP_CERTIFICATE"
// 然后通过 functions.config().agora.appid 访问
const appID = functions.config().agora.appid; // 从环境变量获取
const appCertificate = functions.config().agora.appcertificate; // 从环境变量获取

exports.generateAgoraRtcToken = functions.https.onCall((data, context) => {
  // 1. 验证请求来源（可选，但推荐）
  // if (!context.auth) {
  //   throw new functions.https.HttpsError('unauthenticated', 'The function must be called while authenticated.');
  // }

  // 2. 从请求数据中获取参数
  const channelName = data.channelName;
  const uid = data.uid === 0 ? 0 : parseInt(data.uid || 0); // 确保uid为数字，0表示随机
  const role = data.role === RtcRole.PUBLISHER ? RtcRole.PUBLISHER : RtcRole.SUBSCRIBER; // 确保role为RtcRole枚举值
  let expireTimestamp = parseInt(data.expireTimestamp); // 确保过期时间为整数

  // 3. 参数校验
  if (!appID || typeof appID !== 'string' || appID.length === 0) {
    console.error("Agora App ID is missing or invalid.");
    throw new functions.https.HttpsError('invalid-argument', 'Agora App ID is not configured correctly.');
  }
  if (!appCertificate || typeof appCertificate !== 'string' || appCertificate.length === 0) {
    console.error("Agora App Certificate is missing or invalid.");
    throw new functions.https.HttpsError('invalid-argument', 'Agora App Certificate is not configured correctly.');
  }
  if (!channelName || typeof channelName !== 'string' || channelName.length === 0) {
    throw new functions.https.HttpsError('invalid-argument', 'The function must be called with a valid "channelName".');
  }
  if (isNaN(uid)) {
    throw new functions.https.HttpsError('invalid-argument', 'The "uid" must be a number.');
  }
  if (isNaN(expireTimestamp) || expireTimestamp <= 0) {
    // 默认过期时间为 1 小时
    const currentTime = Math.floor(Date.now() / 1000);
    expireTimestamp = currentTime + 3600; // 1小时
    console.warn(`Invalid or missing expireTimestamp. Setting to default: ${expireTimestamp}`);
  }

  try {
    // 4. 生成 Token
    const token = RtcTokenBuilder.buildTokenWithUid(appID, appCertificate, channelName, uid, role, expireTimestamp);

    // 5. 返回 Token
    return { token: token };
  } catch (error) {
    console.error("Error generating Agora Token:", error);
    throw new functions.https.HttpsError('internal', 'Failed to generate Agora Token.', error.message);
  }
});

firebase deploy --only functions

// 假设使用 Firebase SDK for client
import { getFunctions, httpsCallable } from 'firebase/functions';

const functions = getFunctions();
const generateAgoraRtcToken = httpsCallable(functions, 'generateAgoraRtcToken');

async function getTokenForChannel(channelName, uid, role, expireTimestamp) {
  try {
    const response = await generateAgoraRtcToken({
      channelName: channelName,
      uid: uid, // 0 for random UID, or a specific number
      role: role, // 1 for PUBLISHER, 2 for SUBSCRIBER
      expireTimestamp: expireTimestamp // Unix timestamp in seconds
    });
    console.log("Agora Token:", response.data.token);
    return response.data.token;
  } catch (error) {
    console.error("Error getting Agora Token:", error);
    // 处理错误，例如显示错误消息给用户
    throw error;
  }
}

// 示例调用
// getTokenForChannel("amankachannel", 0, 1, Math.floor(Date.now() / 1000) + 3600); // 1小时后过期