游戏测试机器人搭建 - Player Actor
前言：
第一次写博客，文笔有限，加上半路出身的游测，大佬们别往死里喷，错的地方请指正，在正式介绍之前先简单说下用的框架：Python的 pykka(Actor模型)，测试框架 pytest和测试报告 allure：
阅读前的基础知识
Python 的socket编程，多进程，多线程，队列
Actors做什么
当一个actor接收到消息后，它能做如下三件事中的一件：
- Create more actors; 创建其他actors
- Send messages to other actors; 向其他actors发送消息
- Designates what to do with the next message. 指定下一条消息到来的行为
Actor的组成
Actor是由状态（state）、行为（behavior）、邮箱（mailbox）三者组成的。
- 状态（state）：状态是指actor对象的变量信息，状态由actor自身管理，避免并发环境下的锁和内存原子性等问题。
- 行为（behavior）：行为指定的是actor中计算逻辑，通过actor接收到的消息来改变actor的状态。
- 邮箱（mailbox）：邮箱是actor之间的通信桥梁，邮箱内部通过FIFO消息队列来存储发送发消息，而接收方则从邮箱中获取消息。
Actors一大重要特征在于<font color="#dd0000"> actors之间相互隔离，它们并不互相共享内存</font>。这点区别于上述的对象。也就是说，一个actor能维持一个私有的状态，并且这个状态不可能被另一个actor所改变。
具体Actor介绍可参考：传送门 >> JunChow520的Actor模型介绍
pykka框架的使用
传送门 >> pykka使用说明
引用说明书的例子：
#!/usr/bin/env python3
import pykka
GetMessages = object()
class PlainActor(pykka.ThreadingActor):
def __init__(self):
super().__init__()
self.stored_messages = []
def on_receive(self, message):
if message is GetMessages:
return self.stored_messages
else:
self.stored_messages.append(message)
if __name__ == '__main__':
actor = PlainActor.start()
actor.tell({'no': 'Norway', 'se': 'Sweden'})
actor.tell({'a': 3, 'b': 4, 'c': 5})
print(actor.ask(GetMessages))
actor.stop()
环境
- Python:3.7
- Windows/Linux
正文
测试机器人要用的3个核心Actor(Player,Send,Recv)
Player Actor
Player对象初始化
- 传递参数：用户名、服务器IP和Port、性别、职业，根据项目类型增减；
- 其他Actor的调用：
- Recv Actor：必要的，socket接收数据，后面章节介绍；
- Send Actor：必要的，socket发送数据，后面章节介绍；
- 可自由增加其他的Actor；
- 初始化可设置角色的相关属性，后面根据服务端返回数据进行相关赋值，如：角色的ID，name，资产货币，攻击防御等 ；
#!/usr/bin/env python
# -*- encoding: utf-8 -*-
'''
@File : player.py
@Contact : 512759438@qq.com
@Author : Jian
'''
import pykka
import websocket
import traceback as tb
from proto import ProtoHandler
from remote import RemoteHandler
from util import MsgSwitch, RecvActor, SendActor
TEST_CASE_CALL = None
class Player(pykka.ThreadingActor):
def __init__(self, user_name='', server='SERVER_1',sex=1, job=1):
super(Player, self).__init__()
self.host = SERVER_LIST[server]['GAME_HOST']
self.port = SERVER_LIST[server]['GAME_PORT']
self.web_host = "x.x.x.x"
self.recv_actor = None
self.send_actor = None
self.socket = None
self.proto_handler = ProtoHandler(self)
self.remote_handler = RemoteHandler(self)
'''测试用例执行时需要调用player'''
global TEST_CASE_CALL
TEST_CASE_CALL = self
self.player_id = None
self.state_user_id = 0
self.state_user_name = user_name
self.sys_count = 0
封装消息发送，用来给自己发送消息或者其它Actor调用
def send_msg(self, msg_type=None, data=None):
'''
:param msg_type:消息类型
:param data: 数据
'''
self.actor_ref.tell({
'msg': msg_type,
'data': data
})
Player Actor 实例化之后第一个执行的地方
- 不指定用户的话则随机账号登录
- MSG_GUEST_LOGIN: 消息类型
- 接下来就把消息告诉自己，on_receive会接收到这条消息
def on_start(self):
if self.state_user_name is '':
self.send_msg(MSG_GUEST_LOGIN)
else:
self.send_msg(MSG_LOGIN_INFO)
接收消息及消息处理
- 接收的消息会放进MsgSwitch进行参数检查，MsgSwitch参考C语言switch
- 接下来是用户注册、创角、登录流程
- MSG_LOGIN_INFO：获取玩家的信息
- 获取用户信息后通知 MSG_LOGIN
- MSG_LOGIN：玩家开始连接socket，有角色则开始登录，没有角色则通知 MSG_CREATE_PLAYER
- 连接socket后开启 Send Actor 和 Recv Actor
- 给 Send Actor 发送消息：角色登录需要的参数，Send Actor会进行打包和发给服务端
- MSG_CREATE_PLAYER：
- 把需要的创角参数传给Send Actor，打包后通知服务端要创角
- MSG_PROTO：Recv Actor 从socket.recv接收的数据进行反序列化后会发送过来到这处理
- 如果需要对服务端返回的协议数据进行自动处理，可以在proto模块写上对应处理方法，MSG_PROTO消息类型接收的每一条协议数据都会去proto模块查找有没有对应的处理方法(hasattr和getattr)
- MSG_REMOTE_CMD：后续写到remote再进行结合一起写，不影响运行
def on_receive(self, msg):
for case in MsgSwitch(msg):
# 获取用户信息
if case(MSG_LOGIN_INFO):
account_info = Account(self.state_user_name).login_info()
if account_info['code_str'] == 'OK':
user_into = account_info['user']
self.create_player_params = {
'rd3_token': user_into['token'],
'rd3_userId': user_into['userId'],
'server_list_type': 0,
'sid': 1,
'token': user_into['token'],
}
self.create_player_params.update(Account(self.state_user_name).data)
self.create_player_params.pop('password')
self.create_player_params['cmd'] = 'game_login'
self.send_msg(MSG_LOGIN)
else:print(f'获取角色信息ERROR, 原因: {account_info["code_str"]},{account_info["code"]}')
break
# 用户登录
if case(MSG_LOGIN):
self.socket = websocket.create_connection(f'ws://{self.host}:{self.port}/')
self.recv_actor = RecvActor.start(self, self.socket)
self.send_actor = SendActor.start(self, self.socket)
self.send_actor.tell({MSG_PROTO: self.create_player_params})
break
# 用户创角
if case(MSG_CREATE_PLAYER):
create_data = {
'nickname': self.state_user_name,
'rd3_token': self.create_player_params['rd3_token'],
'rd3_userId': self.create_player_params['rd3_userId'],
'sid': self.create_player_params['sid'],
'token': self.create_player_params['token'],
}
self.send_actor.tell({MSG_PROTO: create_data})
break
# 服务端返回协议处理
if case(MSG_PROTO):
method, data = msg['data']
if hasattr(self.proto_handler, method):
getattr(self.proto_handler, method)(data)
else:
print(f"没有为协议: {method} 定义处理方法, 请前往 proto.py 文件中定义!")
break
# 控制台调用命令
if case(MSG_REMOTE_CMD):
method = msg['method']
method = (type(method) is int and "r" + str(method)) or (type(method) is str and method)
if hasattr(self.remote_handler, method):
getattr(self.remote_handler, method)(msg['data'])
else:
print(f"没有为远程命令: {method} 定义处理方法, 请前往 remote.py 文件中定义!")
break
封装远程命令
- 角色登录后可通过 pykka.ActorRegistry.get_by_class_name('Player') 获取实例对象用远程命令遥控角色
def remote_msg(self, method:str=None, data=None):
'''
调用remote里的方法
:param method: 方法名
:param data: 传入的参数 元组
'''
self.actor_ref.tell({
'msg': MSG_REMOTE_CMD,
'method': method,
'data': data
})
停止Player Actor
- 先停止其他的Actor 再关闭socket，最后关掉自己
def on_stop(self):
self.recv_actor.stop()
self.send_actor.stop()
self.socket.close()
self.socket.shutdown()
self.stop()
log收集
# 打印报错消息
@GetLog(level='fatal')
def on_failure(self, exception_type, exception_value, traceback):
logging.fatal(f'Player: {self.state_user_name} is down.')
logging.fatal(f"ErrorType => {exception_type}")
logging.fatal(f"ErrorValue => {exception_value}")
logging.fatal(f"TraceBack => {tb.print_tb(traceback)}")
self.on_stop()
到这里Player Actor 已经写完了，目前是无法单独运行的，需要结合后面的Send Actor 和 Recv Actor 才能运行，写的不清晰的欢迎在评论留言，接下来的是python编写游戏测试机器人客户端(二)
系列集合
python编写游戏测试机器人客户端(一)
python编写游戏测试机器人客户端(二)
python编写游戏测试机器人客户端(三)
python编写游戏测试机器人客户端(四)
网友评论