角色信息查询

概述

支持通过角色名称、角色ID、OpenID、创角设备ID、创角IP等不同查询方式查询玩家角色明细,包含所属游戏服、所属渠道、创角时间、当前等级、累计充值金额、最后登录时间等信息。

使用前提

  • 请先于“星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口”,正确配置并上线接口“获取角色信息”,才可正常使用“角色信息查询”功能。

  • 关于参数配置

    1. “per_page”、“page”用于支撑查询结果的翻页功能,其余请求参数将作为查询条件。
    2. 除了预置参数外,支持通过“新增参数”自定义添加游戏所需的额外查询条件,也可通过上下箭头调整参数于GM系统对应功能页的显示顺序。
    3. 若存在多个参数需至少必填一项才可提交,可通过“提交设置”设置。
    4. 游戏服、渠道参数
      • 若需使用星云GM系统“游戏服管理”维护的游戏服信息,枚举获取地址可填入__NEBULA_SERVER__
      • 若需使用星云对接中心“渠道配置”维护的渠道信息,枚举获取地址可填入__NEBULA_CHANNEL__
  • 详见对接文档

GM接口配置_列表_获取角色信息

GM接口配置_获取角色信息表单

查询

  • 查询条件
    1. 支持通过角色名称、角色、OpenID、创角设备ID、创角IP等搜索角色信息。
    2. 若有其他期望的查询条件,可以通过 “星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → GM接口管理 → 预置接口 → 获取角色信息” 中“新增参数”自助添加。
  • 查询结果
    1. 默认按创角时间倒序显示。
    2. 为实时获取的数据。

角色信息查询