ngl_server 1.0
基于 Actor 模型的 C++ 服务器框架
nprotocol.h File Reference

声明游戏服务器内部协议相关接口。 More...

#include "actor/protocol/nprotocol_template.h"
#include "actor/generated/pb/net.pb.h"
#include "tools/log/nactor_logitem.h"
#include <limits>

Classes

struct  ngl::np_timerparm
 定时器参数结构体。 More...
struct  ngl::np_robot_pram
 机器人测试参数结构体。 More...
struct  ngl::nactornode
 Actor节点描述结构体。 More...
struct  ngl::np_actor_server_register
 Actor服务器注册请求结构体。 More...
struct  ngl::np_connect_actor_server
 连接到Actor服务器的请求结构体。 More...
struct  ngl::np_actornode_register
 Actor节点注册请求结构体。 More...
struct  ngl::np_actornode_register_response
 Actor节点注册响应结构体。 More...
struct  ngl::np_actorclient_node_connect
 Actor客户端节点连接通知结构体。 More...
struct  ngl::np_actornode_update
 Actor节点路由更新结构体。 More...
struct  ngl::np_actornode_update_server
 Actor节点更新服务器端包装结构体。 More...
struct  ngl::np_actornode_update_mass
 Actor节点批量更新结构体。 More...
struct  ngl::np_actornode_connect_task
 节点连接任务结构体。 More...
struct  ngl::np_actorrole_login
 玩家角色登录通知结构体。 More...
struct  ngl::np_gateway_close_session
 网关关闭会话请求结构体。 More...
struct  ngl::np_actorswitch_process_role
 Actor切换处理角色结构体。 More...
struct  ngl::np_actorswitch_process_plays
 Actor切换处理玩家列表结构体。 More...
struct  ngl::np_actorserver_connect
 Actor服务器连接确认结构体。 More...
struct  ngl::np_actor_session_close
 会话连接关闭通知结构体。 More...
struct  ngl::np_actor_disconnect_close
 玩家断开连接通知结构体。 More...
struct  ngl::np_actor_gatewayid_updata
 Actor网关ID更新结构体。 More...
struct  ngl::np_actor_broadcast
 Actor广播事件结构体。 More...
struct  ngl::np_actor_reloadcsv
 CSV配置文件重新加载请求结构体。 More...
struct  ngl::np_actor_csv_verify_version
 CSV配置文件版本验证结构体。 More...
struct  ngl::np_actor_senditem
 物品发送请求结构体。 More...
struct  ngl::chat
 聊天消息结构体。 More...
struct  ngl::gateway_socket
 网关套接字信息结构体。 More...
struct  ngl::np_actor_gatewayinfo_updata
 网关信息更新结构体。 More...
struct  ngl::np_actor_addmail
 新增邮件请求结构体。 More...
struct  ngl::ncalendar_info
 日历活动信息结构体。 More...
struct  ngl::np_actor_kcp
 KCP会话通知结构体。 More...
struct  ngl::calendar_utc
 日历UTC时间范围结构体。 More...
struct  ngl::np_actor_addnotice
 新增公告请求结构体。 More...
struct  ngl::np_actor_close
 Actor关闭事件结构体。 More...
struct  ngl::np_login_request_info
 登录信息请求结构体。 More...
struct  ngl::np_create_example
 创建副本请求结构体。 More...
struct  ngl::np_example_entergame_ready
 副本进入准备就绪通知结构体。 More...
struct  ngl::np_example_actorid
 副本Actor ID通知结构体。 More...
struct  ngl::np_example_equit
 退出副本请求结构体。 More...
struct  ngl::np_thruput_test
 吞吐量测试结构体。 More...
struct  ngl::np_operator_task
 任务操作结构体。 More...
struct  ngl::np_operator_task_response
 任务操作响应结构体。 More...
struct  ngl::np_get_rank
 获取排行榜信息请求结构体。 More...
struct  ngl::np_get_rank_response
 排行榜信息响应结构体。 More...
struct  ngl::np_activityrank_operator
 活动排行榜操作结构体。 More...
struct  ngl::np_attribute_remove
 属性移除请求结构体。 More...
struct  ngl::np_ukcp_waitrecv
 UKCP等待接收数据结构体。 More...

Enumerations

enum  ngl::E_ACTOR_TIMER {
  ngl::ET_NULL , ngl::ET_MONTH , ngl::ET_WEEK , ngl::ET_DAY ,
  ngl::ET_HOUR , ngl::ET_MIN , ngl::ET_INTERVAL_SEC
}
 定时器类型枚举。 More...

Functions

template<typename T>
void ngl::timerparm_set_parm (np_timerparm *apparm, std::shared_ptr< T > &aparm)
 设置定时器参数的用户自定义数据。

Detailed Description

声明游戏服务器内部协议相关接口。

本文件定义了服务器内部通信所使用的各种协议数据结构,包括:

  • 定时器参数(np_timerparm)
  • 节点注册与发现(nactornode, np_actornode_register 等)
  • 玩家登录与会话管理(np_actorrole_login, np_actor_session_close 等)
  • 游戏逻辑协议(邮件、公告、排行榜、副本等)
  • 网络连接管理(KCP、网关信息更新等)

这些协议结构体用于 Actor 之间的消息传递和服务器节点间的通信。

Enumeration Type Documentation

◆ E_ACTOR_TIMER

定时器类型枚举。

定义了系统支持的各种定时器触发方式,用于不同周期性的任务调度。

Enumerator
ET_NULL 

无效定时器类型

ET_MONTH 

基于日历的月定时器,在每月指定日期和时间触发

ET_WEEK 

基于日历的周定时器,在每周指定星期和时间触发

ET_DAY 

每日定时器,在每天固定时分秒触发

ET_HOUR 

每小时定时器,在每小时固定分秒触发

ET_MIN 

每分钟定时器,在每分钟固定秒触发

ET_INTERVAL_SEC 

固定间隔定时器,以秒为单位循环触发

Function Documentation

◆ timerparm_set_parm()

template<typename T>
void ngl::timerparm_set_parm ( np_timerparm * apparm,
std::shared_ptr< T > & aparm )

设置定时器参数的用户自定义数据。

将类型化的共享指针转换为 void 共享指针并存储到定时器参数中。 允许用户在定时器触发时获取自定义上下文数据。

Template Parameters
T用户自定义参数的类型
Parameters
apparm定时器参数结构体指针
aparm要设置的用户自定义参数共享指针