mobileelement

この記事の内容
  1. xbot.mobile.element
  2. メソッド
  3. click()
  4. dblclick()
  5. longpress()
  6. input()
  7. get_text()
  8. get_attribute()
  9. screenshot()
  10. get_bounding()

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()

この例の実行ロジック: 指定されたスマホとの接続を確立します --> 「好友名称」という名称のスマホの要素を検索します --> スマホ画面内でのスマホの要素の位置を取得します。

APIリファレンスの記事一覧ページの先頭へ ↑