xbot.mobile.element

概述

element接口主要是针对手机元素的操作，如点击、输入、获取元素信息、元素截图等

详情

click

单击手机元素

click(self, *, delay_after=1)
参数：

• delay_after：执行成功后延迟时间，默认延迟1s

返回值：

• 无

示例1:
点击好友头像

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友头像')
    element.click()

dblclick

双击手机元素

dblclick(self, *, delay_after=1)
参数：

• delay_after：执行成功后延迟时间，默认延迟1s

返回值：

• 无

示例1:
双击好友头像

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友头像')
    element.dblclick()

longpress

长按手机元素

longpress(self, *, delay_after=1)
参数：

• delay_after：执行成功后延迟时间，默认延迟1s

返回值：

• 无

示例1:
长按好友头像

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友头像')
    element.longpress()

input

填写手机输入框

input(self, text: str, *, append=False, delay_after=1)
参数：

• text：需要填写到手机输入框中的文本内容
• append：是否追加输入, 追加输入会保留输入框中原有内容, 在原有内容最后面追加写入内容，非追加时写入会覆盖输入框中原有内容, 默认值为False, 非追加写入
• delay_after：执行成功后延迟时间，默认延迟1s

返回值：

• 无

示例1:
在手机聊天输入框中输入内容

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('聊天输入框')
    element.input('cool')

get_text

获取元素的文本内容

get_text(self)
参数：

• 无

返回值：

• str：返回手机元素的文本内容

示例1：
获取 文本框 中的文本内容

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友名称')
    text = element.get_text()
    print(text)

get_attribute

获取元素的属性值

get_attribute(self, name: str)
参数：

• name：元素的属性名

返回值：

• str：元素的属性值

示例1：
获取元素的文本内容属性 -> text

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友名称')
    text = element.get_attribute('text')
    print(text)

screenshot

对元素进行截图并保存

screenshot(self, folder_path, *, filename=None)
参数：

• folder_path, 截图保存的路径
• filename, 截图保存时的文件名, 可为空, 为空时会更具当前时间自动生成文件名

返回值：

• 无

示例1：
对元素进行截图，并将结果保存到D盘根目录下，文件名根据当前时间自动生成

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友名称')
    element.screenshot('D:\\')

get_bounding

获取手机元素在手机屏幕中的位置

get_bounding(self)
参数：

• 无

返回值：

• typing.Tuple：返回元素的位置信息，如(‘x’, ‘y’, ‘width’, ‘height’)

import xbot
from xbot import print, sleep
from .import package
def main(args):
    session = xbot.mobile.connect_by_custom_name('我的安卓手机')
    element = session.find('好友名称')
    list_tuple = element.get_bounding()