Motion API

Motion API

The Motion API makes it possible to develop Android apps for the Sony Smart Imaging Stand IPT-DS10M, and make your app control the pan and tilt axes for this device. If you develop an app for the Smart Imaging Stand, you can get substantial visibility for your app to all Smart Imaging Stand users, when they are searching for compatible apps.

Download the Motion API developer kit and start developing straight away!

Smart Imaging Stand IPT-DS10M.

Smart Imaging Stand IPT-DS10M.

About the Smart Imaging Stand IPT-DS10M
The Smart Imaging Stand is a great device for all parties, as it makes your smartphone sense faces and smiles, and automatically take pictures while running the SmileCatcher app that comes with the device. The Smart Imaging Stand tilts and rotates 360° to keep the subject or subjects in focus. You can also choose to record video while running the SmileCatcher app.

The smartphone will control the Smart Imaging Stand via Bluetooth®. Pairing and connecting is easily done over one-touch NFC. If the smartphone is not NFC-enabled, normal Bluetooth® pairing also works. The Smart Imaging Stand is powered by two AA batteries.

The Smart Imaging Stand supports panning and tilting.

The Smart Imaging Stand supports panning and tilting.

The new Motion API
For developers, the new experimental Motion API will allow your app to control how the Smart Imaging Stand moves around its own axle (pan), and how the smartphone cradle is moved back and forth (tilt).

There are three sub interfaces defined for the Motion API:

  • Configuration
    This sub interface defines the different methods for how the characteristics of the Smart Imaging Stand is updated (for example, firmware versions and speed definitions).
  • Control
    The Control interface contains the actual methods to control the pan and tilt axes of the Smart Imaging Stand.
  • Event
    The Event interface defines the different callback methods for the asynchronous communication.

The Motion API is implemented as a bound service that resides in a host application and follows the Android Messenger pattern. The Motion API developer kit includes a helper class that will ease this implementation, by taking care of the binding to the service, and by setting up the Messengers. This helper class is called SmartImagingStandManager. If you would like to implement your own version of the Messenger pattern, take a look at the Android Messenger pattern page, or check out the SmartImagingStandManager code in the Motion API developer kit to get an idea of how it can be done.

To develop apps using the Motion API, you should be familiar with Java programming in an Android environment. For more information about how the Motion API works, and the architecture for the communication between the smartphone and the Smart Imaging Stand, please see the Developer guidelines in the Motion API developer kit.

New fun and useful use cases
The Motion API opens up for a lot of potential use cases for developers:

  • You could develop a video call- or hangout- type of app.
  • You could develop an app that follows the person talking (for smartphones with stereo microphones).
  • You could develop a turn-based game between two persons sitting in front of each other, with the Smart Imaging Stand in the middle, showing the screen only to the person playing at the moment and then rotating for each turn.
  • If you pair the smartphone with a SmartWatch or SmartWatch 2 (and develop a Smart Extension for your app), there are even more potential use cases when controlling the Smart Imaging Stand from a remote device.

Let your creativity flow, developers!

Product and API support

  • The Motion API itself only supports the Smart Imaging Stand.
  • The Smart Imaging Stand requires Android 4.0 and is optimised for Xperia™ smartphones from Xperia™ Z1 and onwards. Bluetooth™ 2.0 is also required.

About the Motion API developer kit
The Motion API developer kit includes everything you need to get started developing straight away:

  • Motion API constant definitions
  • Helper classes
  • JavaDoc
  • An extension example
  • Developer guidelines documentation

Prerequisites for using the Motion API

  • Android SDK (minimum API level 7)
  • Eclipse with the ADT plug-in or Android Studio

Download and install the Motion API developer kit

  1. Download the Motion API developer kit and unzip into any directory on your computer.
  2. Start Eclipse.
  3. From the file menu, click Import… .
    Import Motion API
  4. Click Existing Android Code Into Workspace.
    Motion API import
  5. Select the directory where you unzipped the Motion API developer kit zip file. Browse to the projects, and import them.
  6. Now the Motion API and the example application are imported into Eclipse.

Start developing
For instructions on how to get started developing apps for the Motion API, see the Developer guidelines in the Motion API developer kit.

Please note that you must pair your smartphone with the Smart Imaging Stand before you start to develop.

Testing must be done on a real device
Since the Smart Imaging Stand is a unique device, there is no way to emulate it with software. You will need an actual Smart Imaging Stand for testing and development.

Expose your Smart Imaging Stand app to all users
If you create a Smart Imaging Stand app, you can get a lot of great visibility towards end users by making you app show up when end users are searching for compatible apps through Smart Connect. From here, users can find all compatible apps filtered out from Google Play™.

To make your app show up in the predefined Google Play™-search, just make sure the Google Play™ description for your app ends with the following text:

Smart Connect extension for Smart Imaging Stand

Questions about the Motion API?
As the Motion API is published as an experimental API, we will only provide basic documentation and limited support. However, if you do have any developer related questions, you could post them at Stack Overflow and we will try to answer them if possible. Just make sure you add the term “Sony” to your question, then we should be able to catch your question.

***

Smart Imaging Stand IPT-DS10M specifications

  • Dimensions: Diameter 127 mm. Height 120 mm.
  • Supports Bluetooth® 2.0 or later.
  • NFC-enabled.
  • Compatibility: The Smart Imaging Stand requires Android 4.0 and is optimised for Xperia™ smartphones from Xperia™ Z1 and onwards. Bluetooth™ 2.0 is also required.
  • LED: Blue, white.
  • Rotation: 360°.
  • Colour: Black.
  • Power supply: 2 x standard AA size batteries.
  • Includes a removable smartphone holder with a standard internal 1/4-20 UNC camera thread for tripod or other mount.
  • Will be on sale from late September on selected markets.

***

More information