connect

この記事の内容
  1. 説明
  2. メソッド
  3. connect()
  4. u2モード
  5. connect()
  6. appiumモード
  7. connect()

説明

  • Dr.Roboではバージョン4.7で新しいスマホ自動化モード【U2】モードと新しいインターフェースが追加されました。
  • 4.7より前に開発されたスマホ用ロボットも引き続き正常に実行できます。
  • 新しく開発するコード版ロボットでは、新しいインターフェースの使用を推奨します。使用する際はインポート方法に注意し、サンプルコードを参照してください。

メソッド

connect()

Appiumモードを使用し、接続パラメータに基づいて指定されたスマホとの接続を確立します。(旧版)

connect(appium_url, platform_name, platform_version, device_name, additional_capabilities=None)

入力パラメータ

appium_url:指定するAppiumサーバーのアドレスです。例:http://127.0.0.1:4723/wd/hub

platform_name:指定するシステムの名称です。例:Android

platform_version:指定するシステムのバージョンです。例:8.0.1

device_name:指定するデバイスのモデルです。例:Galaxy S4

additional_capabilities:その他の設定項目を追加します。型はPythonの辞書オブジェクトです。

戻り値

MobileSession:取得したスマホ接続オブジェクトを返します。

例1

import xbot
from xbot import print, sleep
from .import package


def main(args):
    session = xbot.mobile.connect(
        'http://127.0.0.1:4723/wd/hub', 
        'Android', 
        '8.0.1', 
        'Galaxy S4', 
        additional_capabilities = {
            'newCommandTimeout': 60
            }
        )

この例の実行ロジック: 指定されたスマホとの接続を確立します。

u2モード

connect()

connect(id)

入力パラメータ

id:指定するスマホのidです。コマンドラインでadb devicesを実行すると取得できます。

戻り値

MobileSession:取得したスマホ接続オブジェクトを返します。

例1

import xbot
from xbot import print, sleep 
from .import package


from xbot.mobile import u2 # 注意:u2モードでは必ずこの方法でインポートしてください。


def main(args):
    session = u2.connect('emulator-5554') # xbot.mobile.u2.connect()は使用できません。必ず上記の方法でインポートしてください。
    session.swipe(300, 900, 300, 300)
    elements =  session.find_all('杭州-up相似元素组')
    print(len(elements))
    for element in elements:
        element.click(delay_after=4)
        session.back()

この例の実行ロジック: 指定されたスマホとの接続を確立し、スマホ画面をスワイプして類似要素を検索し、要素をクリックします --> ホーム画面に戻ります。

appiumモード

connect()

Appiumモードを使用して、指定されたスマホとの接続を確立します。

connect(appium_url, platform_name, platform_version, device_name, additional_capabilities=None)

入力パラメータ

appium_url:指定するAppiumサーバーのアドレスです。例:http://127.0.0.1:4723/wd/hub

platform_name:指定するシステムの名称です。例:Android

platform_version:指定するシステムのバージョンです。例:8.0.1

device_name:指定するデバイスのモデルです。例:Galaxy S4

additional_capabilities:その他の設定項目を追加します。Pythonの辞書オブジェクトを入力してください。

戻り値

MobileSession:取得したスマホ接続オブジェクトを返します。

例1

import xbot
from xbot import print, sleep
from .import package


from xbot.mobile import appium


def main(args):
    session = appium.connect('http://127.0.0.1:4725/wd/hub', 'Android', '7', 'XIAOMI 2')
    session.swipe(300, 900, 300, 300)
    elements =  session.find_all('杭州-up相似元素组')
    print(len(elements))
    for element in elements:
        element.click(delay_after=4)
        session.back()

この例の実行ロジック: 指定されたスマホとの接続を確立し、スマホ画面をスワイプして類似要素を検索し、要素をクリックします --> ホーム画面に戻ります。

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