# タッチ - クリック

クラウドフォンの画面上の 1 点をタップします。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。対応機種 でのみ対応。非対応の機種は呼び出しを拒否します。
- **座標**：`pos` はちょうど 2 つの値 `[x, y]` を保持する必要があります。**画面解像度との照合は行われません** — 画面外の座標もそのままデバイスサービスへ渡されます。
- **完了シグナル**：同期的です。`data.status` はジェスチャーが完了すると `finish`、デバイスサービスがキューに入れた場合は `pending` です。一部の機種は常に `finish` を返します。`pending` をポーリングするエンドポイントはありません。
- **リトライ**：重複排除はありません。2 回の呼び出しは 2 回のタップになるため、タイムアウト後に無条件でリトライするとダブルタップになり得ます。
- **補足**：ここでは `duration` を受け取りますが無視します。読み取るのは長押しだけです。

文書化されたビジネスエラー: `33300`, `33301`, `33401`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/cloudphone/touch/click
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    クラウドスマホ ID
    Example: 1558968155668507

  - `pos` (array, required)
    タップ座標 [x, y]。座標系は画面の左上隅を原点 (0, 0) とします。
    Example: [540,960]

  - `duration` (integer)
    押下持続時間（ミリ秒）、長押しに使用。省略した場合、デフォルトの時間が使用されます。
    Example: 2000

## Response 200:

  - `200` (unknown)
    操作成功

## Response 200 fields (application/json):

  - `code` (integer)
    ステータスコード、0は成功を意味します
    Example: 0

  - `msg` (string | null)
    応答メッセージ
    Example: success

  - `data` (object)

  - `data.status` (string)
    実行ステータス
    Example: finish