ブラックフライデーチャージボーナス·$50以上のチャージで$10プレゼント · $100以上のチャージで$25プレゼント·11月30日までチャージ →
ユースケース

クラウドAndroid端末でモバイルゲームをプレイするAIエージェント

クラウドフォンにゲームのAPKをインストールし、高速なAIエージェントにプレイさせます。戦略を書くコーチ、無駄な手の検出、ライブ画面付き。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
phone agent ⏺ mode: fast · coach: on> Play 2048 and reach the 512 tile. swipe left · swipe down · swipe left coach: keep the big tile in the corner ✓ 512 reached · 214 moves
ブラックフライデー

ブラックフライデーチャージボーナス

対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。

11月30日まで

$50をチャージ
+$10
20%ボーナス
$100をチャージ
+$25
25%ボーナス
登録して受け取る

ゲームは、フォームやメニューとは違う意味でAIエージェントにとって難しいものです。画面は毎秒変わり、タップするものの大半はボタンではなく、1手ごとに10秒立ち止まって考えるエージェントはすでに負けています。Lovely Routerのphoneエージェントには、そのためのモードがあります。高速モードでは、意思決定モデルが画面上の要素とスクリーンショットからほぼすべての手を1秒を大きく下回る時間で選び、コーチモデルがその傍らで戦略を書き続け、何も起こらない手は検出されて繰り返されません。実行環境はクラウドフォンです。クラウド上の本物のAndroid 14端末で、どんなAPKでもインストールでき、起動時間1時間あたり$1.20、1分単位の課金です。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Install a game on a Lovely Router cloud phone and start a fast-mode phone run that plays it, then report the result and the coach's strategy.

- Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md
- Create a phone, install the APK, start an agent run with `mode: "fast"` and a goal (what counts as doing well); poll it and read `strategy` and the steps. Delete the phone when done.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the game and what to play>
01

どんな用途に使われるか

自作ゲームのテスト。

エージェントにすべてのビルドの最初のレベルをプレイさせ、どこで詰まったか、どの画面が応答しなくなったか、決まった手数でどこまで進んだかを報告させます。

オンボーディングの確認。

チュートリアル、報酬のポップアップ、ストアのオファー。新しいプレイヤーが助けなしで通過できるでしょうか。

研究とデモ。

エージェントが画面からゲームのルールを学ぶ様子を眺め、コーチが書く戦略を比較し、AIがプレイするゲームを自分のページでライブ表示できます。

02

仕組み

010203
  1. ゲームをインストールする

    ゲームは分割バンドルで配布されることがよくあります。PUT /v1/phones/apks/{name} で一度アップロードするか(1リクエストあたり最大100 MB、分割すれば最大500 MB)、apps に https:// リンクを記載します。.xapk のゲームデータ(OBBファイル)も端末にコピーされます。

  2. 高速実行を開始する

    "mode": "fast" を付けてゴールを送信します。何をプレイするか、何をもって上手くいったとするかを伝えます。「レベルをプレイし、盤面の下部に近いマッチを優先し、150手で止めてスコアを報告する」。

  3. 観察してから結果を読む

    ライブ画面を開いてゲームがプレイされる様子を見ます。実行が終わったら、エージェントの回答、コーチの最新戦略、すべての手を trace=1 で読みます。

03

ゲーム実行を開始する

010203
curl https://lovelyrouter.com/v1/phones/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Open the puzzle game and play level 1. Make the best move you can on each turn. When the level ends, report whether you won and the score shown.",
    "apps": ["puzzle-game.xapk"],
    "mode": "fast",
    "max_steps": 200
  }'

実行は、新しい端末が起動してゲームをインストールする間は queued、その後 running になります。max_steps に達した実行は failed ではなく stopped で終わります。「プレイし続ける」のような終わりのないゴールには、他に終わりがないからです。

04

意思決定モデルとコーチ

高速モードは作業を2つのモデルに分けます。どちらも端末の料金に含まれます。

  • 意思決定モデルがプレイします。各ステップで、画面上の要素から組み立てたメニュー(各要素のタップ、入力、長押し、スクロール、さらに戻る、ホーム、エンター、待機、アプリを開く)とスクリーンショットを受け取るので、リストにない場所(ゲームの駒や画像内のタイルなど)もタップでき、4方向にスワイプできます。不確かなときでも常に最善の推測で行動します。ゲームでは、どんな手でも待つよりましだからです。
  • コーチが考えます。ゴール、直近の手、画面を読み、短い戦略(ゲームなら、どの手を優先するか)と現状のメモを書きます。最初のステップ、数ステップごと、ゲームやアプリが変わったとき、実行が行き詰まって見えるときに動作し、意思決定モデルはコーチを待ちません。各ステップは最新版を使います。実行は strategy、situation、sidecar_updates にこれを表示し、"plan": false でオフにできます。

model で選ぶチャットモデル(デフォルトは gemini-3.8-flash)は、最終回答とあなたへの質問だけを書きます。エージェントが入力するテキストはゴールとあなたの返信から来るもので、でっち上げではありません。チャットモデルが手の選択に関わらないため、高速実行は smart よりはるかに少ないトークンで済みます。

05

何も起こらない手と、リスタートボタン

010203

ゲームは、素朴なエージェントが何度も繰り返す2つのミスに厳しく反応します。

無駄な手。 詰まった盤面をスワイプしたり、動かせないタイルをタップしたりしても、画面はまったく変わりません。エージェントは各スクリーンショットを前のものと比較します。何も変えなかった手はトレースで unchanged と記され、その画面では再試行されず、コーチには実行が行き詰まって見えることが即座に伝わるので、別の提案ができます。

早すぎる諦め。 ゲームの「新しいゲーム」「リスタート」「もう一度」ボタンは常にタップ1回の距離にあり、難しい局面に当たったエージェントは喜んで押します。高速モードでは、ゲームが終わっている(コーチがそう言うか、画面がそう示す)か、ゴールがリスタートを求める場合を除き、これらのボタンは選べる手から外されます。

06

横向きゲームとライブ画面

多くのゲームは横向きに固定されます。その場合スクリーンショットは540×1200ではなく1200×540で返り、座標もそれに従い、ライブ画面もゲームに合わせて回転します。POST /v1/phones/{id}/screen がリンクを返します。どのブラウザでも開け、プラグインは不要で、iframeに埋め込めるので、プレイ中のゲームを自分のページに表示できます。リンクを持つ人はタップも入力もできるため、共有には注意するか、自分のダッシュボードに留めておいてください。

07

後から手を読む

GET /v1/phones/runs/{id}?trace=1 はすべてのステップを列挙します。エージェントが記録したこと、アクションとその引数、前面のアプリ、成功したかどうか、ms 単位の所要時間、そして何も起こらなかった手の unchanged: true です。無駄な手を数え、レベルが止まった地点を見つけ、ゴール内の指示を変えて同じゴールを実行することで2つの戦略を比較できます。

自前のスクリプトボットなら、エージェントを飛ばして端末を直接操作します。GET /v1/phones/{id}/screenshot の後、スクリーンショットの座標で tap または swipe を指定して POST /v1/phones/{id}/actions を呼びます(直接操作)。

08

料金

料金
起動中の端末1時間あたり$1.20、1分単位の課金
高速モードの意思決定モデルとコーチ端末の料金に含まれる
チャットモデル(回答と質問)通常のAPI料金でトークン課金
アップロードしたAPK最初の1 GBは無料、以降は1 GBあたり月$0.30

端末は5分間使われないと無料でスリープし、約2秒でゲームをそのままに復帰します。1時間使われないとアプリとデータごと削除されます。起動には残高に15分の端末時間が必要で、各アカウントは同時に3台まで端末を持てます。1つの前払い残高で端末、モデル、クラウドエージェントをまかなえます。

09

よくある質問

?
AIエージェントは本当にモバイルゲームをプレイできますか?+

はい、限界の範囲内で。高速モードでは画面上の要素とスクリーンショットから1秒を大きく下回る時間で手を選び、コーチが書く戦略に従い、何も起こらなかった手を避けます。素早くルールに従うプレイヤー程度にはプレイできますが、毎秒多くの正確な入力が必要な反射神経ゲームは苦手です。

どんなゲームをプレイできますか?+

Android 14で動作し、APK、.apks、.xapk ファイルからインストールできるゲームなら何でも。ターン制やパズルゲームが最適です。1手ごとを1枚のスクリーンショットから判断できるからです。

エージェントは負けているときにゲームをリスタートしますか?+

いいえ。リスタート、新しいゲーム、もう一度のボタンは、ゲームが終わっているかゴールがリスタートを求める場合を除き、手から外されます。

コーチは追加料金がかかりますか?+

いいえ。意思決定モデルとコーチは端末の時間料金に含まれます。最終回答と質問を書くチャットモデルだけがトークン単位で課金されます。

エージェントがプレイ中にゲームを見られますか?+

はい。ライブ画面のリンクで、どのブラウザでも、または自分のページのiframeで、縦向きでも横向きでも端末を表示できます。

同じ端末でアプリの残りをテストするには、AIモバイルアプリテストをご覧ください。実行のすべてのフィールドはphone APIリファレンスにあります。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。