Actions

Touch a point in the frame

Tap a point in the live-view frame, as if someone touched the camera’s own screen there. Send absolute coordinates (x 0-639, y 0-479) or normalized 0-1 values — the latter is what you want for a tap or click on a live view.

This is not `setAFAreaPosition`

setAFAreaPosition drags the focus box to a point and leaves it there. A touch seeds the camera’s subject tracking: the camera locks onto whatever is at that point and then follows it on its own. You cannot get that by rewriting positions from a client. Touch also works in focus areas that have no movable box — Wide, face priority — where setAFAreaPosition has nothing to move.

Read the result with getTrackingFrame.

The camera decides what a touch does

The SDK property that would select the touch behaviour (FunctionOfRemoteTouchOperation) is unsupported on Alpha bodies including the ILCE-7M4 — only broadcast bodies can choose. A touch does whatever the body’s own Touch Func. in Shooting is set to (MENU > Setup > Touch Operation > Touch Panel Settings > Shooting Screen), and that setting is not exposed over this API:

Touch Func. in Shooting	What `remoteTouch` does
`Touch Focus` (ILCE-7M4 default)	Moves the AF frame, like `setAFAreaPosition`. `getTrackingFrame` stays empty.
`Touch Tracking`	Starts subject tracking at the point. `getTrackingFrame` reports the box.

Both were measured on an ILCE-7M4. Note the touch is accepted even when the body’s Touch Operation is Off — that setting governs the physical screen, not the remote property.

A 200 does not mean tracking started

The camera accepts the write and then decides. With Touch Tracking set, a touch on a point with nothing trackable — measured on flat wall and blown-out window areas — returns 200 and produces no tracking frame at all. Always read getTrackingFrame to find out what actually happened.

Touches land close to where they are asked for but not exactly: the camera snaps to the nearest feature it can hold. Measured on an ILCE-7M4, 320,240 landed at 320,239 and 200,300 at 209,297, while points near the edges pulled further in — 0,479 landed at 35,445.

Leave a beat between touches. Firing several within a second or so, or immediately after a cancelRemoteTouch, made the camera drop tracking entirely until it was left alone.

When this returns 400

Touch is gated on the camera reporting it as currently available. On the ILCE-7SM3 and ILCE-7C it is movie-mode only; other bodies gate it on focus mode or on live view running. A rejected touch says which gate failed.

Requires priority key pc-remote.

POST

api

cameras

{cameraId}

actions

touch

Touch a point in the frame

curl --request POST \
  --url http://{host}:{port}/api/cameras/{cameraId}/actions/touch \
  --header 'Content-Type: application/json' \
  --data '
{
  "x": 319,
  "y": 239,
  "normalized": {
    "x": 0.5,
    "y": 0.5
  }
}
'

import requests

url = "http://{host}:{port}/api/cameras/{cameraId}/actions/touch"

payload = {
    "x": 319,
    "y": 239,
    "normalized": {
        "x": 0.5,
        "y": 0.5
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({x: 319, y: 239, normalized: {x: 0.5, y: 0.5}})
};

fetch('http://{host}:{port}/api/cameras/{cameraId}/actions/touch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/api/cameras/{cameraId}/actions/touch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'x' => 319,
    'y' => 239,
    'normalized' => [
        'x' => 0.5,
        'y' => 0.5
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/api/cameras/{cameraId}/actions/touch"

	payload := strings.NewReader("{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://{host}:{port}/api/cameras/{cameraId}/actions/touch")
  .header("Content-Type", "application/json")
  .body("{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/api/cameras/{cameraId}/actions/touch")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  },
  "data": {}
}

{
  "success": false,
  "message": "Camera not connected",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  }
}

Path Parameters

cameraId

string

required

Camera identifier (e.g. D10F60149B0C)

Body

application/json

Supply either x and y, or a normalized object. If both are present, normalized wins. Same coordinate space as AFAreaPositionRequest.

integer

Touch point X in the camera's coordinate space.

Required range: 0 <= x <= 639

integer

Touch point Y in the camera's coordinate space.

Required range: 0 <= x <= 479

normalized

object

Touch point as 0-1 fractions of the live view — use this for a tap or click position without converting to the SDK's coordinate space.

Show child attributes

Response

Touch sent. Confirm what the camera locked onto with getTrackingFrame.

Generic envelope returned by most camera operations. The shape of data varies per endpoint — most operations return an empty or null data; operations that return structured data document a specific shape. SDK-generated types can treat data as an opaque map for generic endpoints.

success

boolean

required

message

string

camera

object

Camera info embedded in API responses

Show child attributes

data

object

Touch a point in the frame

curl --request POST \
  --url http://{host}:{port}/api/cameras/{cameraId}/actions/touch \
  --header 'Content-Type: application/json' \
  --data '
{
  "x": 319,
  "y": 239,
  "normalized": {
    "x": 0.5,
    "y": 0.5
  }
}
'

import requests

url = "http://{host}:{port}/api/cameras/{cameraId}/actions/touch"

payload = {
    "x": 319,
    "y": 239,
    "normalized": {
        "x": 0.5,
        "y": 0.5
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({x: 319, y: 239, normalized: {x: 0.5, y: 0.5}})
};

fetch('http://{host}:{port}/api/cameras/{cameraId}/actions/touch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/api/cameras/{cameraId}/actions/touch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'x' => 319,
    'y' => 239,
    'normalized' => [
        'x' => 0.5,
        'y' => 0.5
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/api/cameras/{cameraId}/actions/touch"

	payload := strings.NewReader("{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://{host}:{port}/api/cameras/{cameraId}/actions/touch")
  .header("Content-Type", "application/json")
  .body("{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/api/cameras/{cameraId}/actions/touch")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"x\": 319,\n  \"y\": 239,\n  \"normalized\": {\n    \"x\": 0.5,\n    \"y\": 0.5\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  },
  "data": {}
}

{
  "success": false,
  "message": "Camera not connected",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  }
}

Server

Connection

Properties

Actions

Live View

Events

SD Card

Settings

Touch a point in the frame

This is not `setAFAreaPosition`

The camera decides what a touch does

A 200 does not mean tracking started

When this returns 400

Path Parameters

Body

Response