mobileelement
この記事の内容
xbot.mobile.element
クリック、入力、要素情報の取得、要素のスクリーンショットの撮影など、スマホの要素に対する操作を行います。
メソッド
click()
スマホの要素をシングルクリックします。
click(self, delay_after=1)
入力パラメータ
delay_after:実行成功後の待機時間です。デフォルトの待機時間は1秒です。
戻り値
なし
例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:実行成功後の待機時間です。デフォルトの待機時間は1秒です。
戻り値
なし
例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:実行成功後の待機時間です。デフォルトの待機時間は1秒です。
戻り値
なし
例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:win32の入力欄に入力するテキスト内容です。
append:末尾に追記するかどうかを指定します。末尾に追記する場合、入力欄の既存の内容は保持されます。指定しない場合のデフォルト値はFalse(末尾に追記しない)です。
delay_after:実行成功後の待機時間です。デフォルトの待機時間は1秒です。
戻り値
なし
例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)
この例の実行ロジック: 指定されたスマホとの接続を確立します --> 「好友名称」という名称のスマホの要素を検索します --> 要素のテキスト内容の属性 'text' を取得します --> 結果を出力します。
screenshot()
要素のスクリーンショットを撮影して保存します。
screenshot(self, folder_path, filename=None)
入力パラメータ
folder_path:スクリーンショットの保存先パスです。
filename:スクリーンショットを保存する際のファイル名です。空にすることができ、空の場合は現在時刻に基づいてファイル名を自動生成します。
戻り値
なし
例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.screenshot('D:\\')
この例の実行ロジック: 指定されたスマホとの接続を確立します --> 「好友名称」という名称のスマホの要素を検索します --> 要素のスクリーンショットを撮影し、結果をDドライブのルートディレクトリに保存します。ファイル名は現在時刻に基づいて自動生成します。
get_bounding()
get_bounding(self)
入力パラメータ
なし
戻り値
Tuple:要素の位置情報を返します。例:('x', 'y', 'width', 'height')
例1
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()
この例の実行ロジック: 指定されたスマホとの接続を確立します --> 「好友名称」という名称のスマホの要素を検索します --> スマホ画面内でのスマホの要素の位置を取得します。