com.webos.service.camera2

Note
This API has been available since API level 11.

API Summary

Provides an interface to capture and stream images from a camera that is connected to a webOS device.

Note: Currently, only V4L2 USB cameras are supported.

It provides the following features:

Live Camera Preview: Continuously streams live data from the camera to the shared memory (SystemV and POSIX). The data on the shared memory can be used by applications either using the native shared memory API for Linux or through multimedia middleware framework like GStreamer.
Capture Images: Allows capturing images in various modes. You can take single or multiple images based on the selected mode.
Control Camera Settings: Allows you to adjust the camera frame size, output format, and properties such as brightness, exposure, and so on.

API Usage:

Overview of the API

N/A

Methods

close

ACG: camera.operation

Added: API level 11

Description

Closes the connection between the camera and the webOS device.

Parameters

Name

Required

Type

Description

handle

Required

Number

Indicates the handle for the device obtained using the open() API.

pid

Optional

Number

Indicates the client process ID that should be unregistered (or eliminated) from the pool the camera service manages.

Note: When the camera was opened with a valid PID, this parameter is required (mandatory), otherwise the device is not closed and the method returns false.

Call Returns

Name	Required	Type	Description
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.
pid	Optional	Number	Indicates the client process ID

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/close '{"handle":886}'

Response:

{
"returnValue":true
}

Example : App requires shared memory synchronization, with default signal

# luna-send -n 1 -f luna://com.webos.service.camera2/close '{"handle":6393, "pid": 1804}'

Response:

{
"returnValue": true,
"pid": 1804
}

Example : App requires shared memory synchronization, with a specified signal

# luna-send -n 1 -f luna://com.webos.service.camera2/close '{"handle":2516, "pid": 1430}'

Response;

{
"returnValue": true,
"pid": 1430
}

getCameraList

ACG: camera.query

Added: API level 11

Description

Gets the list of cameras connected to the webOS device. Returns IDs for each of the cameras connected to the device.

Parameters

None

Call Returns

Name	Required	Type	Description
deviceList	Optional	Object array: deviceList	Indicates the list of cameras connected to the device. Note: The method returns an empty list if no camera is connected.
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/getCameraList '{}'

Response:

{
   "deviceList":[
      {
         "id":"camera1"
      }
   ],
   "returnValue":true
}

getEventNotification

ACG: camera.operation

Added: API level 11

Description

Gets a notification when there is a change in any of the camera properties and formats or when there is an error event on your device.

Parameters

Name	Required	Type	Description
subscribe	Required	Boolean	Indicates if subscribed to get notifications. Possible values are: true: Subscribed for notifications false: Not subscribed

Name

Required

Type

Description

Required

Boolean

Indicates if subscribed to get notifications.

Possible values are:

true: Subscribed for notifications
false: Not subscribed

Call Returns

Name	Required	Type	Description
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
id	Optional	String	Indicates the id of the camera.
eventType	Optional	String	Indicates whether there is a change in camera format or properties. Possible values are: format: If there is a change in camera format. properties: If there is a change in camera properties.
propertiesInfo	Optional	Object: camera_properties	Indicates the details of camera properties when eventType is properties.
formatInfo	Optional	Object: camera_format	Returns the details of the camera format when eventType is format. Note: It may not return all the values mentioned in the formatInfo object.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example: With subscription

# luna-send -n 1 -f luna://com.webos.service.camera2/getEventNotification '{
"subscribe":true
}'

Response (If no event received):

{
"returnValue":true
}

Response (If properties are changed) :

{
"id":"camera1",
"eventType":"properties",
"returnValue":true,
"propertiesInfo":{
"frequency":0,
"saturation":255,
"brightness":255,
"autoWhiteBalance":false,
"contrast":100,
"whiteBalanceTemperature":0,
"gain":255,
"backlightCompensation":true,
"sharpness":255
}
}

Response (If format changed to JPEG) :

{
"id":"camera1",
"eventType":"format",
"returnValue":true,
"formatInfo":{
"format":"JPEG"
}
}

getFd

ACG: camera.operation

Added: API level 13

Description

Provides the FD (File Descriptor) for the POSIX shared memory.

Note: It returns the FD by attaching it using LS2 attach fd interface to the client.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the handle for the device obtained using the open() API.

Call Returns

Name	Required	Type	Description
returnValue	Optional	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Name

Required

Type

Description

returnValue

Optional

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example scenario

# luna-send -n 1 -f luna://com.webos.service.camera2/getFd '{"handle": 886}'

Response:

{
"returnValue":true
}

Sample for fetching the fd from getFd response:

getFdCb(LSHandle *lsHandle, LSMessage *message, void *user_data)
{
...
LS::Message ls_message(message);
LS::PayloadRef payload_ref = ls_message.accessPayload();
fd = payload_ref.getFd();
...
}

getInfo

ACG: camera.query

Added: API level 11

Description

Gets information about a camera that is connected to the webOS device.

Parameters

Name	Required	Type	Description
id	Required	String	Indicates id of the camera obtained using the getCameraList() API.

Call Returns

Name	Required	Type	Description
info	Optional	Object array: capture_info	Returns information about the camera.
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/getInfo '{"id":"camera1"}'

Response:

{
"info":{
"type":"camera",
"builtin":false,
"details":{
"video":{
"maxWidth":800,
"maxHeight":600,
"frameRate":30,
"format":"YUV|JPEG|"
},
"picture":{
"maxWidth":800,
"maxHeight":600,
"format":"YUV|JPEG|"
}
},
"name":"Logitech, Inc."
},
"returnValue":true
}

getProperties

ACG: camera.operation

Added: API level 11

Description

Gets the current settings of the connected camera device.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the handle for the device obtained using the open() API.
params	Optional	String array	Indicates the list of specific properties for which settings are returned.

Call Returns

Name	Required	Type	Description
params	Required	Object: camera_properties	Indicates the current properties of the camera.
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example: With handle

# luna-send -n 1 -f luna://com.webos.service.camera2/getProperties '{
"handle":502
}'

Response:

{
"returnValue": true,
"params": {
"exposure": {
"max": 10000,
"min": 78,
"default": 312,
"step": 1,
"value": 312
},
"backlightCompensation": {
"max": 3,
"min": 0,
"default": 0,
"step": 1,
"value": 0
},
"frequency": {
"max": 2,
"min": 0,
"default": 1,
"step": 1,
"value": 1
},
"saturation": {
"max": 100,
"min": 0,
"default": 58,
"step": 1,
"value": 58
},
"brightness": {
"max": 64,
"min": -64,
"default": 0,
"step": 1,
"value": 0
},
"tilt": "not support",
"sharpness": {
"max": 7,
"min": 1,
"default": 2,
"step": 1,
"value": 2
},
"focusAbsolute": "not support",
"contrast": {
"max": 95,
"min": 0,
"default": 0,
"step": 1,
"value": 0
},
"gamma": {
"max": 300,
"min": 100,
"default": 100,
"step": 1,
"value": 100
},
"autoWhiteBalance": {
"max": 1,
"min": 0,
"default": 1,
"step": 1,
"value": 1
},
"hue": {
"max": 2000,
"min": -2000,
"default": 0,
"step": 100,
"value": 0
},
"gain": "not support",
"resolution": {
"YUV": [
"640,480,25",
"1920,1080,5",
"1280,720,6",
"320,240,25",
"1024,768,6",
"1280,1024,6",
"160,120,25"
],
"JPEG": [
"640,480,25",
"1920,1080,5",
"1280,720,6",
"320,240,25",
"1024,768,6",
"1280,1024,6",
"160,120,25"
]
},
"autoFocus": "not support",
"whiteBalanceTemperature": {
"max": 6500,
"min": 2800,
"default": 4600,
"step": 1,
"value": 4600
},
"autoExposure": {
"max": 3,
"min": 0,
"default": 3,
"step": 1,
"value": 3
},
"pan": "not support",
"zoomAbsolute": "not support"
}
}

Example: With handle and params

# luna-send -n 1 -f luna://com.webos.service.camera2/getProperties '{
"handle":502,
"params":[
"frequency",
"saturation"
]
}'

Response:
{
"returnValue": true,
"params": {
"saturation": {
"max": 100,
"min": 0,
"default": 58,
"step": 1,
"value": 58
},
"frequency": {
"max": 2,
"min": 0,
"default": 1,
"step": 1,
"value": 1
}
}
}

getSolutions

ACG: camera.operation

Added: API level 21

Description

Gets the current status of the supported camera solutions.

Parameters

Name	Required	Type	Description
handle	Optional	Number	Indicates the handle for the device. It is obtained using the open() API. Note: Either one of "handle" or "id" must be provided.
id	Optional	String	Indicates the camera id for the device. It is obtained using the getCameraList() API. Note: Either one of "handle" or "id" must be provided.

Name

Required

Type

Description

handle

Optional

Number

Indicates the handle for the device. It is obtained using the open() API.

Note: Either one of "handle" or "id" must be provided.

Optional

String

Indicates the camera id for the device. It is obtained using the getCameraList() API.

Note: Either one of "handle" or "id" must be provided.

Call Returns

Name	Required	Type	Description
returnValue	Required	Boolean	Indicates the status of operation. Possible values are: true - Indicates that the operation was successful. false - Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
solutions	Optional	Object array: solutions	Provides current status of the supported camera solutions.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section of this method for details.

Error Codes Reference

Error Code	Error Text	Error Description
11	Camera device is not opened	Camera device is not opened
32	Wrong param	Input parameter is incorrect.
35	Unknown error	Unknown error happens
47	Wrong handle	Device handle number is incorrect.

Example

Example : Get solutions by specifying the -id- parameter

# luna-send -n 1 -f luna://com.webos.service.camera2/getSolutions '{"id": "camera1"}'

Response:

{
"returnValue": true,
"solutions": [
{
"name": "FaceDetectionCNN",
"params": {
"enable": false
}
},
{
"name": "FaceDetection",
"params": {
"enable": false
}
}
]
}

Example : Get solutions by specifying the -handle- parameter

# luna-send -n 1 -f luna://com.webos.service.camera2/getSolutions '{"handle": 2214}'

Response:

{
"returnValue": true,
"solutions": [
{
"name": "FaceDetectionCNN",
"params": {
"enable": false
}
},
{
"name": "FaceDetection",
"params": {
"enable": false
}
}
]
}

open

ACG: camera.operation

Added: API level 11

Description

Establishes a connection between a camera and the webOS device. Returns the device handle for this connection instance.

Parameters

Name	Required	Type	Description
id	Required	String	Indicates the unique identifier of the camera obtained using the getCameraList() API.
mode	Optional	String	Indicates whether the calling app can update the camera settings. Possible values are: primary: Calling app can update the camera settings. secondary: Calling app cannot update the camera settings. Note: If no mode is selected, then the first call to open the camera gets primary access, and others are given secondary access. If there are multiple calls with the mode set as primary, then only the first call gets primary access.
pid	Optional	Number	Indicates the process ID of the client process which intends to get notified of a shared memory writing-done event by a signal. Note: The client process ID should be the one that is actually on the running context. If a client app A calls another process B and process B is the one who is waiting for a writing-done event and reading the shared memory synchronously, then process B must call open. Otherwise, if A calls open with its open process ID, it would kill the app.
sig	Optional	Number	Indicates the ID of the signal by which the camera service reports a shared memory writing-done event and a client app will get notified of it. The number of possible values are 29 from 1 (SIGHUP) to 31 (SIGSYS) except for 9 (SIGKILL) and19 (SIGSTOP). Note: Must be provided with "pid" The process ID and the signal ID passed by payload will be registered (or added) to a pool that the camera service manages. If the signal ID is not specified in the payload, the default signal number 10 (SYGUSR1) will be applied. If an invalid value is passed, the camera service will reject the request and return false.
appId	Optional	String	ID of the application Note: App must have permission to open the camera.

Call Returns

Name	Required	Type	Description
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
handle	Optional	Number	Indicates the unique identifier for each connection instance.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.
pid	Optional	String	The process ID.
sig	Optional	String	The Signal ID.

Example

Example : Open command with no mode

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
"id":"camera1"
}'

Response:

{
"returnValue":true,
"handle":9383
}

Example : Open command with the mode set to primary

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
"id":"camera1",
"mode":"primary"
}'

Response:

{
"returnValue":true,
"handle":886
}

Example : Error case - Open command with mode as primary (when an application has already opened with mode as primary)

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
"id":"camera1",
"mode":"primary"
}'

Response:

{
"errorCode":44,
"returnValue":false,
"errorText":"Already another device opened as primary"
}

Example : App does not require synchronized shared memory synchronization

# luna-send -f -n 1 luna://com.webos.service.camera2/open '{
"id":"camera1",
"appId": "com.webos.app.browser"
}'

Response:

{
"returnValue": true,
"handle": 4503
}

Example : App does not require synchronized shared memory synchronization - case to open with primary mode

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
"id":"camera1",
"appId": "com.webos.app.browser",
"mode":"primary"
}'

Response:

{
"returnValue":true,
"handle":886
}

Example : App does not require synchronized shared memory synchronization - case when an application has already opened with mode as primary.

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
"id":"camera1",
"appId": "com.webos.app.browser",
"mode":"primary"
}'

Response:

{
"errorCode":44,
"returnValue":false,
"errorText":"Already another device opened as primary"
}

Example : App requires shared memory synchronization, with default signal

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
  "id": "camera1",
  "appId": "com.webos.app.browser",
  "pid": 1804
}'

Response:

{
   "returnValue": true,
"pid": 1804,
   "handle": 6393,
   "sig": 10
}

Example : App requires shared memory synchronization, with a specified signal

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
  "id": "camera1",
  "appId": "com.webos.app.browser",
  "pid": 1430,
  "sig": 2
}'

Response:

{
"returnValue": true,
"pid": 1430,
"handle": 2516,
"sig": 2
}

Example : App passes an invalid signal

# luna-send -n 1 -f luna://com.webos.service.camera2/open '{
  "id": "camera1",
  "appId": "com.webos.app.browser",
  "pid": 1970,
  "sig": 19
}'

Response:

{
"errorCode": 50,
"returnValue": false,
"errorText": "Failed to register pid with specified signal"
}

setFormat

ACG: camera.operation

Added: API level 11

Description

Sets the size and format of the preview stream. This includes the height and width of the frame and the format in which data is to be written to the shared buffer.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the camera handle obtained using the open() API.
params	Required	Object: camera_format	Indicates the size and format of the preview stream.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/setFormat '{
"handle":9383,
"params":{
"width":640,
"height":480,
"format":"JPEG",
"fps":30
}
}'

Response:

{
"returnValue":true
}

setProperties

ACG: camera.operation

Added: API level 11

Description

Sets the properties of the connected camera device.

Parameters

Name

Required

Type

Description

handle

Required

Number

Indicates the handle for the device obtained using the open() API.

params

Required

Object: camera_properties

Indicates an object containing properties of the camera.

Note: Even though the API succeeds when an empty params object is provided, we recommend that at least one value must be included.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/setProperties '{
"handle": 9383,
"params":
{
"contrast": 100
}
}'

Response:

{
"returnValue":true
}

setSolutions

ACG: camera.operation

Added: API level 21

Description

Enables and disables camera solutions.

Parameters

Name	Required	Type	Description
handle	Optional	Number	Indicates the handle for the device. It is obtained using the open() API. Note: Either one of "handle" or "id" must be provided.
id	Optional	String	Indicates the camera id for the device. It is obtained using the getCameraList() API. Note: Either one of "handle" or "id" must be provided.
solutions	Required	Object array: solutions	Specifies the current status of the supported camera solutions.

Name

Required

Type

Description

handle

Optional

Number

Indicates the handle for the device. It is obtained using the open() API.

Note: Either one of "handle" or "id" must be provided.

Optional

String

Indicates the camera id for the device. It is obtained using the getCameraList() API.

Note: Either one of "handle" or "id" must be provided.

solutions

Required

Object array: solutions

Specifies the current status of the supported camera solutions.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of operation.

Possible values are:

true - Indicates that the operation was successful.
false - Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section of this method for details.

Error Codes Reference

Error Code	Error Text	Error Description
11	Camera device is not opened	Camera device is not opened
32	Wrong param	Input parameter is incorrect.
35	Unknown error	Unknown error happens
47	Wrong handle	Device handle number is incorrect.

Example

Example : Set solutions by specifying the -id- parameter

# luna-send -n 1 -f luna://com.webos.service.camera2/setSolutions '{
"id": "camera1",
"solutions": [
{
"name": "AutoContrast",
"params": {
"enable": true
}
},
{
"name": "FaceDetection",
"params": {
"enable": true
}
}
]
}'

Response:

{
"returnValue": true
}

Example : Set solutions by specifying the -handle- parameter

# luna-send -n 1 -f luna://com.webos.service.camera2/setSolutions '{
"handle": 4231,
"solutions": [
{
"name": "AutoContrast",
"params": {
"enable": true
}
},
{
"name": "FaceDetection",
"params": {
"enable": true
}
}
]
}'

Response:

{
"returnValue": true
}

startCapture

ACG: camera.operation

Added: API level 11

Description

Starts capturing images using the camera. The captured images are stored as separate files at the location given by the "path" parameter.

The default file name is of the format PictureDDMMYYYY-HHMMSS, where DDMMYYYY-HHMMSS is current date and time.

Example: /tmp/Picture11022019-204128.jpeg

By default, captured images are saved in the /tmp/ folder.

Parameters

Name

Required

Type

Description

handle

Required

Number

Indicates the handle for the device obtained using the open() API.

params

Required

Object: camera_capture_format

Indicates the size and format of the images to be captured.

path

Optional

String

Indicates the location where the captured images are to be saved.

Note: The API returns an error (error code 45) if the path specified is read-only.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example : Without specifying the location

# luna-send -n 1 -f luna://com.webos.service.camera2/startCapture '{
"handle": 9383,
"params":
{
"width": 640,
"height": 480,
"format": "JPEG",
"mode":"MODE_BURST",
"nimage":2
}
}'

Response:

{
"returnValue":true
}

Example : With location specified

# luna-send -n 1 -f luna://com.webos.service.camera2/startCapture '{
     "handle": 9383,
     "params":
          {
             "width": 640,
             "height": 480,
             "format": "JPEG",
             "mode":"MODE_BURST",
             "nimage":2
          },
     "path":"/tmp/"
}'

Response:

{
"returnValue":true
}

Example : Error case - With read-only location specified

Response:

{
"errorCode": 45,
"returnValue": false,
"errorText": "Cannot write at specified location"
}

startPreview

ACG: camera.operation

Added: API level 11

Description

Starts the preview stream on the camera and writes live data to the shared memory (SystemV or POSIX).

The method returns a key for accessing the shared memory, which is required for applications to access data from the shared memory.

Note: Use the setFormat() method to set the size and format of the preview stream.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the handle for the device obtained using the open() API.
params	Required	Object: camera_memory_source	Defines the type and source of the memory.

Call Returns

Name	Required	Type	Description
key	Optional	Number	Indicates the key for memory access. For System V, key can be accessed directly for camera device buffers For Posix, shared memory fd has to be shared over getFd API for accessing the camera device buffers
returnValue	Required	Boolean	Indicates the status of the operation. Possible values are: true: Indicates that the operation was successful. false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.
errorCode	Optional	Number	The error code for the failed operation.
errorText	Optional	String	Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example : System V shared memory

# luna-send -n 1 -f luna://com.webos.service.camera2/startPreview '{
"handle":9383,
"params":{
"type":"sharedmemory",
"source":"0"
}
}'

Response:

{
"returnValue":true,
"key":7011
}

Example : Posix Shared Memory

# luna-send -n 1 -f luna://com.webos.service.camera2/startPreview '{
"handle":9383,
"params":{
"type":"posixshm",
"source":"0"
}
}'

Response:

{
"returnValue":true,
"key":9
}

stopCapture

ACG: camera.operation

Added: API level 11

Description

Stops camera from capturing images in the continuous mode. Continuous mode captures frames in succession till the stopCapture() method is called.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the handle for the device obtained using the open() API.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/stopCapture '{"handle":9383}'

Response:

{
"returnValue":true
}

stopPreview

ACG: camera.operation

Added: API level 11

Description

Stops the preview stream.

Parameters

Name	Required	Type	Description
handle	Required	Number	Indicates the handle for the device obtained using the open() API.

Call Returns

Name

Required

Type

Description

returnValue

Required

Boolean

Indicates the status of the operation.

Possible values are:

true: Indicates that the operation was successful.
false: Indicates that the operation failed. Check the "errorCode" and "errorText" fields for details.

errorCode

Optional

Number

The error code for the failed operation.

errorText

Optional

String

Indicates the reason for the failure of the operation. See the "API Error Codes Reference" section for details.

Example

Example code

# luna-send -n 1 -f luna://com.webos.service.camera2/stopPreview '{"handle":9383}'

Response:

{
"returnValue":true
}

Objects

camera_capability

Contains the capability of the camera

Name	Required	Type	Description
min	Optional	Number	The minimum value of the control.
max	Optional	Number	The maximum value of the control.
default	Optional	Number	The default value of the control.
step	Optional	Number	The step value of the control.
value	Optional	Number	The current value of the control.

camera_capture_format

Indicates the size and the format in which images are to be captured.

Name	Required	Type	Description
width	Required	Number	Indicates the width of the image to be captured. Default width: 640 pixels
height	Required	Number	Indicates the height of the image to be captured. Default value: 480 pixels
format	Required	String	Indicates the format of the image. Possible values are: JPEG YUV Default: YUV
nimage	Optional	Number	Indicates the number of images to be captured. Note: The field is required for capturing images in burst mode.
mode	Required	String	Indicates the mode in which the image is to be captured. Possible values are: MODE_ONESHOT: For one-shot mode MODE_BURST: For burst mode MODE_CONTINUOUS: For continuous mode

camera_format

Indicates the size and format for the preview stream and images.

Name	Required	Type	Description
width	Required	Number	Indicates the width of the image to be captured. Default: 640 pixels
height	Required	Number	Indicates the height of the image to be captured. Default: 480 pixels
format	Required	String	Indicates the format of the image. Possible values are: JPEG YUV Default: YUV
fps	Required	Number	Indicates the frames per second.

camera_memory_source

Indicates the type of the memory for the preview data to be written.

Name	Required	Type	Description
type	Required	String	Indicates the type of the memory. Possible options: sharedmemory - For System V shared memory. posixshm - For posix shared memory Note: Currently supports only shared memory.
source	Required	String	Indicates the ID of memory source, if the client has created the memory and wants data to be written at that specific address.

Name

Required

Type

Description

type

Required

String

Indicates the type of the memory.

Possible options:

sharedmemory - For System V shared memory.
posixshm - For posix shared memory

Note: Currently supports only shared memory.

source

Required

String

Indicates the ID of memory source, if the client has created the memory and wants data to be written at that specific address.

camera_properties

Contains the properties of the camera.

Name	Required	Type	Description
sharpness	Optional	Object: camera_capability	Indicates the camera sharpness
autoExposure	Optional	Object: camera_capability	Indicates the camera auto exposure
autoFocus	Optional	Object: camera_capability	Indicates the camera auto focus
autoWhiteBalance	Optional	Object: camera_capability	Indicates the camera auto white balance
backlightCompensation	Optional	Object: camera_capability	Indicates the camera backlight compensation value
brightness	Optional	Object: camera_capability	Indicates the camera brightness
contrast	Optional	Object: camera_capability	Indicates the camera contrast
exposure	Optional	Object: camera_capability	Indicates the exposure value
focusAbsolute	Optional	Object: camera_capability	Indicates the focus value
frequency	Optional	Object: camera_capability	Indicates the camera power line frequency
gain	Optional	Object: camera_capability	Indicates the camera gain
gamma	Optional	Object: camera_capability	Camera gamma
hue	Optional	Object: camera_capability	Indicates the camera hue
pan	Optional	Object: camera_capability	Indicates the pan value
resolution	Optional	Object	Indicates the supported format resolutions in string array format.
saturation	Optional	Object: camera_capability	Indicates the camera saturation
tilt	Optional	Object: camera_capability	Indicates the tilt value
whiteBalanceTemperature	Optional	Object: camera_capability	Indicates the white balance temperature
zoomAbsolute	Optional	Object: camera_capability	Indicates the zoom value

capture_info

Indicates the information about the camera.

Name	Required	Type	Description
details	Optional	Object: details	Indicates the video and the picture details.
name	Optional	String	Indicates the name of the camera.
type	Optional	String	Indicates the type of the device. Possible values are: camera
builtin	Optional	Boolean	Indicates if the camera is built-in or not.

details

Indicates the picture and the video details of the camera device.

Name	Required	Type	Description
video	Optional	Object: video	Indicates the video information.
picture	Optional	Object: picture	Indicates the image information.

deviceList

Contains the list of cameras connected to the webOS device.

Name	Required	Type	Description
id	Optional	String	Indicates the unique camera identifier.

params

Detailed information of a specific solution.

Name	Required	Type	Description
enable	Required	Boolean	Status of solution [enable/disable each solution]

picture

Indicates the image size and image format.

Name	Required	Type	Description
maxWidth	Optional	Number	Width value
maxHeight	Optional	Number	Height value
format	Optional	String	Supported formats

solutions

Information of all supported camera solutions.

Name	Required	Type	Description
name	Required	String	Name of supported solution.
params	Required	Object: params	Detailed information of a specific solution.

video

Indicates the video size and the video format.

Name	Required	Type	Description
maxWidth	Optional	Number	Indicates the width value.
maxHeight	Optional	Number	Indicates the height value.
format	Optional	String	Gives the supported format for video.
frameRate	Optional	Number	Indicates the video frame rate.

API Error Codes Reference

Error Code	Error Text	Error Description
2	Cannot close device	Device cannot be closed.
3	Cannot open device	Device cannot be opened.
5	Cannot start device	Preview stream cannot be started.
6	Cannot stop device	Preview stream cannot be stopped.
7	Device already closed	Device is already closed.
8	Device is already open	Device is already opened.
9	Device is already started	Preview stream is already started.
10	Device is already stopped	Preview stream is already stopped.
11	Device not opened	Device is not opened.
12	Device not started	Preview stream is not yet started.
13	No Device	There is no device connected corresponding to input ID.
19	Parsing error	Luna command parsing error.
22	Param missing	One or more parameters are missing in luna command.
23	Request Timeout	Requested operation is timed out.
29	Device unsupported	Device is not supported.
30	Format unsupported	Format is not supported.
32	Wrong param	Input parameter is incorrect.
38	Unknown error	Unknown error.
44	Already another device opened as primary	Only one application can open a camera device as primary. Other application will not be allowed to open camera if an application has already opened with primary priority.
45	Cannot write at specified location	Cannot write at the specified location.