client.host.protocol

protocol

类：

名称	描述
AdbHostConfig	由外部为基于 ADB 的主机提供的配置。
WindowsHostConfig	由外部为 Windows 实现提供配置。
WindowsNativeHostConfig	由外部为基于原生 API（无 AHK 依赖）的 Windows 实现提供配置。
Instance	代表一个可运行环境的实例（如一个模拟器）。

函数：

名称	描述
tcp_ping	通过 TCP ping 检查主机和端口是否可达。

AdbHostConfig dataclass

由外部为基于 ADB 的主机提供的配置。

WindowsHostConfig dataclass

由外部为 Windows 实现提供配置。

WindowsNativeHostConfig dataclass

由外部为基于原生 API（无 AHK 依赖）的 Windows 实现提供配置。

属性：

名称	类型	描述
avoid_border_click	bool	点击坐标为 (0, ) 或 (, 0) 时，是否自动偏移以避免点到窗口边框。默认开启。
click_animation	AnimationParams | None	点击前移动鼠标到目标位置时使用的动画参数。为 None 表示瞬间跳转，不做动画。
swipe_animation	AnimationParams | None	swipe（拖拽）操作默认使用的动画参数。

avoid_border_click class-attribute instance-attribute

avoid_border_click: bool = True

点击坐标为 (0, ) 或 (, 0) 时，是否自动偏移以避免点到窗口边框。默认开启。

click_animation class-attribute instance-attribute

click_animation: AnimationParams | None = None

点击前移动鼠标到目标位置时使用的动画参数。为 None 表示瞬间跳转，不做动画。

swipe_animation class-attribute instance-attribute

swipe_animation: AnimationParams | None = None

swipe（拖拽）操作默认使用的动画参数。

Instance

Bases: Generic[T_HostConfig], ABC

代表一个可运行环境的实例（如一个模拟器）。 使用泛型来约束 create_device 方法的配置参数类型。

方法：

名称	描述
refresh	刷新实例信息，如 ADB 端口号等。
start	启动模拟器实例。
stop	停止模拟器实例。
create_device	根据实现名称和类型化的主机配置创建设备。

refresh abstractmethod

refresh()

刷新实例信息，如 ADB 端口号等。

start abstractmethod

start()

启动模拟器实例。

stop abstractmethod

stop()

停止模拟器实例。

create_device abstractmethod

create_device(impl: DeviceImpl, host_config: T_HostConfig) -> Device

根据实现名称和类型化的主机配置创建设备。

参数：

名称	类型	描述	默认
impl	DeviceImpl	设备实现的名称。	必需
host_config	T_HostConfig	一个类型化的数据对象，包含创建所需的所有外部配置。	必需

返回：

类型	描述
Device	配置好的 Device 实例。

tcp_ping

tcp_ping(host: str, port: int, timeout: float = 1.0) -> bool

通过 TCP ping 检查主机和端口是否可达。

参数：

名称	类型	描述	默认
host	str	主机名或 IP 地址	必需
port	int	端口号	必需
timeout	float	超时时间（秒）	1.0

返回：

类型	描述
bool	如果主机和端口可达，则返回 True，否则返回 False