本文介绍如何利用网易会议组件（NEMeetingKit）的扩展性特性，通过透传字段实现业务定制化需求，帮助您在现有接口基础上扩展更多功能。

透传机制

NEMeetingKit 通过透传字段提供上层业务相应的扩展能力，使您能够在不修改 SDK 的情况下实现自定义业务逻辑。透传字段包括：

• 会议透传字段：NEStartMeetingParams.extraData，用于传递会议级别的自定义数据。
• 成员透传字段：NEMeetingParams.tag，用于传递参会者级别的自定义数据。

以上透传字段允许在应用层传入自定义 JSON 数据，在会议流程中的不同环节被解析和使用，实现个性化功能。

在使用透传字段实现业务扩展时，请注意以下数据结构设计实践：

• 层次化的 JSON 结构：将不同类型的数据按模块组织，避免扁平化结构。
• 使用命名空间：使用前缀或嵌套对象来区分不同功能模块的数据。
• 版本控制：在数据中包含版本号，便于后续兼容性处理。
• 避免传输敏感信息：透传字段可能在网络传输中被拦截，建议您对敏感数据进行加密后再传输。
• 使用令牌而非原始凭据：传输短期有效的令牌而非长期凭据
• 控制数据大小：遵循透传字段的大小限制（extraData 2KB，tag 1KB），建议只传输必要数据，避免冗余。
• 延迟加载：对非即时需要的大型数据，考虑使用 ID 引用并在需要时再加载。
• 异常处理：透传数据的解析应当包含异常处理，以防数据格式不符合预期导致应用崩溃。

设置会议透传字段 (extraData)

会议透传字段 extraData 支持在创建会议时传入自定义数据，最大支持 2KB 的字符串。

javascriptconst neMeetingKit = NEMeetingKit.getInstance();
const meetingService = neMeetingKit.getMeetingService();

// 创建会议参数
const params = {
    displayName: '张三',
    extraData: '{"businessId":"10086","projectName":"项目方案讨论","deptCode":"D2023","priority":"high"}',
}
// 使用设置好的参数创建会议
meetingService.startMeeting(params).then(() => {
    // 创建会议成功
}).catch((error) => {
    // 创建会议失败
});

设置成员透传字段 (tag)

成员透传字段 tag 用于标识参会者的身份信息或附加属性，最大支持 1024 字节。这些信息将在会议中与用户关联，并可用于自定义处理逻辑。

javascriptconst neMeetingKit = NEMeetingKit.getInstance();
const meetingService = neMeetingKit.getMeetingService();

const params = {
    displayName: '张三',
    tag: '{"businessId":"10086","projectName":"项目方案讨论","deptCode":"D2023","priority":"high"}',
}
// 使用设置好的参数创建会议
meetingService.startMeeting(params).then(() => {
    // 创建会议成功
}).catch((error) => {
    // 创建会议失败
});

在会议中获取透传数据

在会议进行过程中，您可以通过两种主要方式获取和使用之前设置的透传数据。

您可以随时通过调用 NEMeetingKit 提供的接口来主动获取当前会议的完整信息，包括透传数据：

javascript
const neMeetingKit = NEMeetingKit.getInstance();
const meetingService = neMeetingKit.getMeetingService();

const meetingInfo = await meetingService.getCurrentMeetingInfo().then((result) => {
    // 获取当前会议信息成功
    const meetingInfo = result.data;
    const extraData = meetingInfo.extraData;
    const tag = meetingInfo.userList[0].tag;
}).catch((error) => {
    // 获取当前会议信息失败

处理透传数据

获取到透传数据后，您可以实现多种定制化功能：

1. 身份识别与权限控制：根据成员 tag 中的角色信息，动态调整会议中可用的功能。
2. 业务关联：将会议与您的业务系统关联，例如显示关联的项目信息或客户资料。
3. 界面定制：基于 extraData 中的配置，调整会议界面的布局或主题。
4. 行为跟踪：记录特定业务相关的会议行为，用于后续分析或报告生成。