Sony Smart headset products Developer specifications

Transcription

1 November 2013 Sony Smart headset products Developer specifications

2 Copyright 2013 Sony Mobile Communications AB. All rights reserved. Xperia is a trademark of Sony Mobile Communications AB. Other brands, company or product names mentioned herein are trademarks of their respective owners. You are hereby granted a limited license to download and/or print a copy of this document for personal use. Any rights not expressly granted herein are reserved. First edition (November 2013) This document is published by Sony Mobile Communications AB, without any warranty*. Improvements and changes to this text necessitated by typographical errors, inaccuracies of current information or improvements to programs and/or equipment, may be made by Sony Mobile Communications AB at any time and without notice. Such changes will, however, be incorporated into new editions of this document. Printed versions are to be regarded as temporary reference copies only.

3 Preface Developer World For the latest technical news, tutorials and development tools go to. About this document This document contains hardware and software specifications for Sony Smart headset products, describing its capabilities and characteristics. It is intended for developers who want to develop extension apps for Smart headset products. To make the best of this document, you should be familiar with the concepts described in the How to use the Smart Extension APIs document. We also recommended that you look at the Smart Extension API code examples provided with the Sony Add-on SDK package. User interface guidelines can be found in this document. Information on the Sony Add-on SDK can be found in the How to use the Sony Add-on SDK document. All these documents are included in the Sony Add-on SDK documentation. Document conventions Typographical conventions Code is written in Courier New font: <action android:name="com.sonyericsson.intent.action " /> Entity references to applications and their components are written in italics: TheApplication, TheBroadcastReceiver, AndroidManifest.xml Placeholders to be replaced with real values are written in italics within angle brackets: <your class> 3

4 Document history Change history Version First version 4

5 Contents Detailed specifications for Sony Smart headset products... 6 Smart Wireless Headset pro... 6 Stereo Bluetooth Headset SBH Smart Bluetooth Handset SBH Smart Extension APIs compatibility... 9 Unsupported features Display Additional display information for Smart Wireless Headset pro Battery Additional battery information for Smart Wireless Headset pro Background process Publishing on Google Play UI guidelines for Smart Wireless Headset pro Icon design Host application Host app icon dimensions Smart Wireless Headset pro icon overview Application view Event view More information Trademarks and acknowledgements

6 Detailed specifications for Sony Smart headset products The Sony Smart headset products are accessories designed to complement and extend the functionality of Android mobile devices. Sony Smart headsets are wireless headsets that use Bluetooth to communicate with the phone. The product line currently includes the Smart Wireless Headset pro (MW1), Stereo Bluetooth Headset SBH50, and Smart Bluetooth Handset SBH52. To make the best of this document, you should be familiar with concepts described in the How to use the Smart Extension APIs document included with the Sony Add-on SDK documentation kit. Smart Wireless Headset pro The Smart Wireless Headset pro is a Smart Accessory that uses Bluetooth to communicate with the phone. The Smart Wireless Headset pro supports the Notification API, a Smart Extension API described later in this document. The accessory can display incoming events and read out event texts in the headphones. Figure 1. Smart Wireless Headset pro. The accessory is equipped with: 1) Next key 2) Play key 3) Previous key 4) Back key 5) Micro USB connector 6) Housing 7) Micro SD card slot 6

7 Stereo Bluetooth Headset SBH50 The Stereo Bluetooth Headset SBH50 is a Smart Accessory that uses Bluetooth to communicate with the phone. The Stereo Bluetooth Headset SBH50 supports the Notification API, a Smart Extension API described later in this document. The accessory can display incoming events and read out event texts in the headphones. Figure 2. Stereo Bluetooth Headset SBH50. The accessory is equipped with: 1) Volume controls 2) NFC detection area 3) Headset jack 4) Next key 5) Music key/select key 6) Previous key 7) Back key/menu key 8) Power key 9) Micro USB port 10) Action key 7

8 Smart Bluetooth Handset SBH52 The Smart Bluetooth Handset SBH52 is a Smart Accessory that uses Bluetooth to communicate with the phone. The Smart Bluetooth Handset SBH52 supports the Notification API, a Smart Extension API described later in this document. The accessory can display incoming events and read out event texts in the headphones or loudspeaker. Figure 3. Smart Bluetooth Handset SBH52. The accessory is equipped with: 1) Ear speaker 2) Action key 3) Microphone 4) Micro USB port 5) Volume controls 6) Headset jack 7) NFC detection area 8) Loudspeaker 9) Power key 10) Back key/menu key 11) Previous key 12) Music key/select key 13) Next key 8

9 Smart Extension APIs compatibility In order to develop apps for Smart Accessories, you can use a specific set of APIs included with the Sony Add-on SDK, called the Smart Extension APIs. A Smart Extension is actually an Android app that has been extended to work with Smart Accessory products. This means you can either take your existing app to add support for the Smart Extension APIs, or you can create a completely new app that works on Smart Accessories. The app will still be installed on your device, as the Smart Extension APIs make it possible to communicate with the Smart Accessories. Note: For details on the Sony Add-on SDK, refer to the How to use the Sony Add-on SDK document. For details on Smart Extensions and the Smart Extension APIs, refer to the How to use the Smart Extension APIs document. The Smart Wireless Headset pro, Stereo Bluetooth Headset SBH50, and Smart Bluetooth Handset SBH52 are all compatible with the following Smart Extension APIs: Registration and capabilities API This API is used by the host application to inform your app (Smart Extension) about the capabilities of the accessory. It is also used by your Smart Extension to inform the host application about which of the other APIs that are used. Notification API Use this API to have the Smart Extension display incoming events and read out event texts in the headphones. Additionally, the Smart Wireless Headset pro is compatible with the following Smart Extension API: Control API Use this API to get access to and gain full control of the screen and keys. The application layer of the Android stack can show all the Smart Extensions that use the Control API. Note: The Registration and capabilities API, Control API, and Notification API are each described in more detail in the How to use the Smart Extension APIs document. 9

10 Unsupported features Some features of the Smart Extension APIs are not available when you are developing Smart Extension apps for Smart headset products, but they are accessible through the phone. This means, for example, that you use the phone to read data such as sensor data, use it in your app, and provide a result through a notification. The following list shows the unsupported features: Widgets Browse notification history Actions in notifications Touch screen Vibrator Sensors Display The display for the Smart Wireless Headset pro, Stereo Bluetooth Headset SBH50, and Smart Bluetooth Handset SBH52 is 128 pixels wide, 36 pixels high and has two colours; black and white. A Smart Extension app that uses the Control API is in control of the entire display. This Smart Extension app sends its images to the host application, which converts the images to a format that is supported by the Smart Wireless Headset pro. Images sent to the host application should be in.png format. For text rendering, the recommended typeface is DEFAULT_BOLD. We do not recommended using anti-aliasing when drawing text, since grey pixels will be shown as white on the monochrome display and the text would look strange. Unfortunately, you cannot disable anti-aliasing in Android s TextView. Use the drawtext function in the Canvas class instead (see the Smart Extension API reference files for examples). Additional display information for Smart Wireless Headset pro For a extension that uses the Control API, the Smart Wireless Headset pro supports key events through CONTROL_KEY_EVENT_INTENT or ControlExtension.onKey(). Control extensions can use all keys except the power key and the back key. When a Smart Extension app is visible on the display, the back key is used to close the Smart Extension app. Each display update must update the 10

11 entire screen. Images that are smaller or larger than the screen are scaled to fit the screen. Any x or y offset is ignored. Battery The Smart headset products are high performance Smart Accessories. It is therefore important to use the battery power wisely. The host application on the Android device and the Sony Add-on SDK include some functionality to preserve the battery. See the Smart Accessories architecture section in the How to get started with the Smart Extension APIs document for more information on the host application. Additional battery information for Smart Wireless Headset pro For the Smart Wireless Headset pro, it is also important that the Smart Extension apps follow these recommendations: Don not use too much white colour in your images. Control Extension: avoid sending full screen images when it isn t necessary (send partial screen-updates instead). Control Extension: avoid using Control.SCREEN_STATE_ON. Background process All Smart Extension apps are run in a service. Android treats services as background processes. Android has a limitation on the number of background processes that can be run simultaneously. When this limit is exceeded the Android system stops the least recently used process. This might happen even if the Smart Extension app is currently showing on the display, since the Android system is not aware of this. Normally this is not a problem for Smart Extensions apps that are only shown for a short while and that the user is directly interacting with. The helper classes in SmartExtensionUtils also contain some functionality to help an extension recover if it was stopped when the user was interacting with an event. For Smart Extension apps that run for a longer time and that should not be interrupted, you can use Service.startForeground() to make the system consider it to be something the user is actively aware of. The side effect is that a notification is shown in the status bar as long as the service is in foreground state. 11

12 Publishing on Google Play If you create a Smart headset app, you can get a lot of great visibility toward end users by making your app show up when end users are searching for compatible apps through Smart Connect (technically from the host application, but in the Smart Connection user interface). From here, users can find all compatible apps filtered from Google Play. For Smart Wireless Headset pro apps: To make your Smart Wireless Headset pro app show up in the pre-defined Google Play search, just make sure the Google Play description for your app includes the following string (we recommend at the bottom, on its own line): LiveWare extension for Smart Wireless Headset pro For Stereo Bluetooth Headset SBH50 apps: To make your Stereo Bluetooth Headset SBH50 app show up in the pre-defined Google Play search, just make sure the Google Play description for your app includes the following string (we recommend at the bottom, on its own line): Smart Connect extension for Notification API For Smart Bluetooth Handset SBH52 apps: To make your Smart Bluetooth Handset SBH52 app show up in the pre-defined Google Play search, just make sure the Google Play description for your app includes the following string (we recommend at the bottom, on its own line): Smart Connect extension for Notification API 12

13 UI guidelines for Smart Wireless Headset pro Icon design These are general guidelines for creating icons for extension applications: An icon should be simple and easy to understand. An icon should be in balance with the surrounding icons and not stand out. Avoid combining many different colours; maximum three is preferable. See also the Android application icons, defined at: Icon examples: Figure 2. Icon examples. 13

14 96 pixels 88 pixels Developer World Host application There is one host application for each Smart Accessory. The hardware unit communicates through Bluetooth with a host application that runs on the phone. The host application together with the accessory software controls what is shown on the hardware. See the Smart Accessories architecture section in the How to get started with the Smart Extension APIs document for more information on the host application. The following screen shows the extension list view in the host application: HOST_APP_ICON_URI Figure 3. Extension list view in the host application. Host app icon dimensions This section contains recommendations for icon design and size. You can see the differences between actual icon size and icon design area for each screen below. This helps you to be consistent with icon sizes in other applications. All icons should be in.png format. HOSTAPP_ICON_URI 96x96 px (xhdpi) Colour 96 pixels 88 pixels Transparent area 14

15 72 pixels 66 pixels 48 pixels 44 pixels 36 pixels 34 pixels Developer World 72x72 px (hdpi) Colour 72 pixels 66 pixels Transparent area 48x48 px (mdpi) Colour 48 pixels 44 pixels Transparent area 36x36 px (ldpi) Colour 36 pixels 34 pixels Transparent area Smart Wireless Headset pro icon overview The Bluetooth headset Smart Wireless Headset pro has an OLED display with a screen size of 128 x 36 pixels. Graphics used should only be black and white. Application view Application icons appear at the application level. 15

16 Event view The event icon is show on the event screen. 16

17 More information For information regarding the latest Sony Add-on SDK updates, check out sonymobile.com/sonyaddonsdk. You can also access the Sony Add-on SDK API references on Developer World. Sony, "make.believe" is a trademark or registered trademark of Sony Corporation. Bluetooth is a trademark or registered trademark of Bluetooth SIG, Inc. Android and Google Play, are trademarks or registered trademarks of Google Inc. All other trademarks and copyrights are the property of their respective owners. 17