概述
- 支持游戏内邮件的增删改查、定时发送及发送结果的回调展示。
- 支持全服邮件、角色邮件等不同邮件类型。
- 因邮件可能存在道具奖励发放等敏感信息，故邮件的增删改均需二次确认。
使用前提
- 请先于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口”，正确配置并上线以下接口，才可正常使用“邮件管理”功能：
- 发送全服邮件
- 发送角色邮件
- 撤回邮件
- 关于参数配置
- 除了预置参数外，支持通过“添加参数”添加各游戏接口所需的自定义请求参数。
- 支持通过“参数排序”调整参数于GM系统功能界面的显示顺序。
- 若存在多个请求参数需至少必填一项才可提交的情况，可通过“提交设置”设置。
- 邮件接口中使用的推送对象“游戏服”、“渠道”参数，将默认填充在星云配置的游戏服及渠道信息作为枚举值获取接口
- 游戏服
- 若“获取游戏当前可用的游戏服列表”接口已上线，默认填充此接口地址作为游戏服数据源；
- 若“获取游戏当前可用的游戏服列表”接口未上线，默认填充
星云GM系统“游戏服管理”列表，即默认使用星云GM系统“游戏服管理”信息；若需正常使用星云“游戏服管理”，请确保“同步星云游戏服变更信息”接口已上线。
- 渠道
- 若“获取游戏当前可用的渠道列表”接口已上线，默认填充此接口地址作为渠道数据源；
- 若“获取游戏当前可用的渠道列表”接口未上线，默认填充
星云对接中心“渠道配置”列表，即默认使用星云对接中心“渠道配置”信息。
- 游戏服
- 邮件接口中使用的“发送道具”参数，若“获取道具名称列表”接口已上线，将默认填充此接口作为道具数据源。
- 上述参数默认填充的枚举值获取接口，均支持替换为游戏自定义接口。
- 详见 GM接口管理使用手册、GM接口对接文档。
全服邮件
支持 添加、修改、撤回、查询 全服邮件。
添加全服邮件
- 支持设置邮件标题、发件人、发送时间、失效时间、发送游戏服、邮件内容、发送道具、黑名单。
- 发送时间，支持立即发送 或 定时发送。
- 发送对象，支持面向多个 游戏服 或 渠道 发送。
- 面向游戏服发送，若使用星云GM“游戏服管理”维护的游戏服信息，在游戏服选择时：
- 在设置发送时间后，支持筛选邮件发送时已开服的游戏服：若勾选，则一键选中表单填写时游戏服管理中 部署状态=已部署 且 开服时间≤发送时间 的游戏服。
- 支持开关“新增游戏服时自动追加”；开，即当此游戏在表单提交后失效时间之前新增了未删除的游戏服，则自动追加归属为当前全服邮件发送游戏服。
- 面向渠道发送，若使用星云维护的渠道信息，则在发送渠道选择时，支持开关“新增官方渠道时自动追加”；开，即当此游戏在表单提交后失效时间之前使用官方渠道模版创建了 配置状态=已完成 且 启用状态=启用 的渠道，则将自动追加归属为当前全服邮件发送渠道。
- 面向游戏服发送，若使用星云GM“游戏服管理”维护的游戏服信息，在游戏服选择时：
- 邮件内容，支持富文本编辑，提供 插入链接 等样式。
- 发送道具，支持设置多种道具及数量的组合方案。
- 黑名单，即所选游戏服的玩家中不允许接收此邮件的角色列表。
- 邮件记录添加后，星云将在到达“发送时间”时调用“发送全服邮件”接口向游戏下发邮件配置信息。
- 点击每条邮件记录的“复制”，可快速添加相同配置信息的邮件。
修改全服邮件
- 未达发送时间即“未通知游戏发送”的邮件，及“已删除或通知游戏撤回”的邮件，支持修改。
- 邮件记录修改后，星云将在到达“发送时间”时调用“发送全服邮件”接口向游戏下发邮件最新配置信息。
删除全服邮件
- 仅未达发送时间即“未通知游戏发送”的邮件，支持删除。
- 邮件记录删除后，则不向游戏推送此邮件配置信息。
撤回全服邮件
- 仅已达发送时间且未撤回，即状态为“已通知游戏发送”的邮件，支持撤回。
- 邮件记录撤回后，星云将即时调用“撤回邮件”接口通知游戏。
查看发送结果
- 若游戏提供发送结果回调，则状态为“已通知游戏发送”的邮件，支持查看发送结果。
- 发送结果将显示总计的发送游戏服数、成功数、失败数，及各游戏服发送明细。
邮件记录查询
- 支持通过邮件标题、邮件内容、发送游戏服、发送渠道、发送状态、通知状态、发送道具等搜索邮件。
- 查询结果，默认按创建时间倒序显示；发送时间、创建时间、更新时间，支持手动排序。
角色邮件
支持 添加、修改、撤回、查询 角色邮件。
添加角色邮件
- 支持设置邮件标题、发件人、发送时间、失效时间、角色ID、邮件内容、发送道具。
- 邮件内容，支持富文本编辑，提供 插入链接 等样式。
- 角色ID，支持直接输入或批量导入多个角色。
- 发送道具，支持设置多种道具及数量的组合方案。
- 邮件记录添加后，星云将在到达“发送时间”时调用“发送角色邮件”接口向游戏下发邮件配置信息。
- 点击每条邮件记录的“复制”，可快速添加相同配置信息的邮件。
修改角色邮件
- 未达发送时间即“未通知游戏发送”的邮件，及“已删除或通知游戏撤回”的邮件，支持修改。
- 邮件记录修改后，星云将在到达“发送时间”时调用“发送角色邮件”接口向游戏下发邮件最新配置信息。
删除角色邮件
- 仅未达发送时间即“未通知游戏发送”的邮件，支持删除。
- 邮件记录删除后，则不向游戏推送此邮件配置信息。
撤回角色邮件
- 仅已达发送时间且未撤回，即状态为“已通知游戏发送”的邮件，支持撤回。
- 邮件记录撤回后，星云将即时调用“撤回邮件”接口通知游戏。
查看发送结果
- 若游戏提供发送结果回调，则状态为“已通知游戏发送”的邮件，支持查看发送结果。
- 发送结果将显示总计的发送角色数、成功数、失败数，及各角色发送明细。
邮件记录查询
- 支持通过邮件标题、邮件内容、角色ID、发送状态、通知状态、发送道具等搜索邮件。
- 查询结果，默认按创建时间倒序显示；发送时间、创建时间、更新时间，支持手动排序。
