getServiceObject()

Description:

The getServiceObject method creates an object that is used to access the services made available through a Service API. This object is referred to as a "service object".

Syntax:

so = device.getServiceObject(provider, interface);

Arguments:

provider:

This is a text string that defines the service provider name, that is, the name of the type of service object to create.
interface:

This is a text string that defines the supported interface for the specified service provider.

**Table:** Service API providers and interfaces
Service API	Provider	Interface
AppManager	`Service.AppManager`	`IAppManager`
Calendar	`Service.Calendar`	`IDataSource`
Contacts	`Service.Contact`	`IDataSource`
Landmarks	`Service.Landmarks`	`IDataSource`
Location	`Service.Location`	`ILocation`
Logging	`Service.Logging`	`IDataSource`
Media Management	`Service.MediaManagement`	`IDataSource`
Messaging	`Service.Messaging`	`IMessaging`
Sensor	`Service.Sensor`	`ISensor`
SystemInfo	`Service.SysInfo`	`ISysInfo`

Return value:

If the call succeeds, the getServiceObject method returns a service object; otherwise it returns undefined.

Remarks:

The getServiceObject method is a factory method found on the device object.
To ensure backward compatibility, always check in your JavaScript code that the device object exists before calling the getServiceObject method. For example:
```
if (device != "undefined")
  device.getServiceObject("Service.MediaManagement", "IDataSource");
```

Example code:

The following example creates a service object for the Media Management Service API:

var so = device.getServiceObject("Service.MediaManagement", "IDataSource");