MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9
Harmattan API Showcase application Harmattan API Showcase
Version: 1.0.0

Harmattan API Showcase application showcases the key APIs of the MeeGo 1.2 Harmattan API offering. The showcase application utilizes APIs with QML bindings as much as possible, but falls back to using C++ code when there's no QML API available for a particular functionality. The demonstrated APIs include system information, messaging, NFC, location, multimedia, camera, sensors, etc. To help application developers with their application development for Nokia N9, source code of showcase application is available here - zip or tar.gz . And here is the debian package.

Application splash screen Application main screen


This software, including documentation, is protected by copyright controlled by Nokia Corporation. All rights reserved. You are entitled to use this application in accordance with the Harmattan API Showcase Application Agreement.

Short Message Service (SMS)

The application window will let you send SMS to a selected contact or a phone number entered in "To:" field. A contact can be selected by tapping on "+" button or type phone number by tapping on "Add Contact.". After a valid phone number or contact is added tap on "Send" button to send the short message.

Initial SMS screen User can type message and input phone number SMS is sent successfully

Tweet by SMS

The application window will let you send twitter message through SMS from your mobile. The number displayed in "To:" field is the twitter service number for your current region. Type a message and tap on "Send" button to send the twitter message.

Initial tweet screen User can type message Tweet is sent successfully

NOTE: The phone number must be already registered with respective account from twitter website to successfully post messages from this application.

Send vCard by NFC

The application window will let you share a contact through NFC with other devices. Select the contact you want to share in contacts selection window and bring the phone near target device when asked to share the contact. This example showcases only a simple usecase. However, a list of NFC related code examples can be found here from developer.nokia.com.

Select contact to write to NFC tag Selected contact is ready to NFC send Selected contact is ready to NFC send Selected contact is NFC sent

NOTE: Enable NFC hardware before you use this application.

Show/Pick Location

The application window demonstrates the following key features of location APIs.

  • geocoding - geographical co-ordinates ( latitude and longitude ) of a location.
  • reverse geocoding - human readable street address or place name.
  • maps
  • accessing current coordinate information
  • pick a location on the map by long pressing
  • access information for a specific or selected map location
Initial location screen Location full screen Selected location details page

Seven wonders of the world

The application window demonstrates the following key features of location and landmarks APIs.

  • geocoding - geographical co-ordinates ( latitude and longitude ) of a location.
  • reverse geocoding - human readable street address or place name.
  • maps
  • tag a location on map
  • pick a tagged location on the map by long pressing
  • access information for a selected tag
Initial seven wonders screen List for old and new wonders of the works screen Wonder of the world details screen 1 Wonder of the world details screen 2

Play Audio

This part of application showcases the following key features of multimediakit ( audio ) APIs.

  • access audio media on the device
  • select a audio track to play
  • access meta data of the tracks
  • play, pause selected track
  • seek through playing track
Audio thumbnail screen Play Audio screen Play Audio screen

The application window lets you to choose audio media from the list present on device. In audio play window you can play, pause selected track, navigate through audio tracks by tapping on next and previous buttons, seek through track by flicking/tapping on the progress bar, view duration and track information.

Play Video

This part of application showcases the following key features of multimediakit ( video ) APIs.

  • access video media on the device
  • select a video to play
  • access meta data of the video
  • play, pause selected video
  • seek through playing video
Video thumbnail screen Play Video screen Play Video screen with video meta data

The application lets you to choose a video from the list present on device. In video play window you can play, pause selected track, seek through track by flicking/tapping on the progress bar. The meta data area of the video can be toggled by tapping on the video region in the window.

View Image

This part of application showcases the following key features of multimediakit ( images ) APIs.

  • access images present on device
  • usage of gallery models to display images
  • access meta data of images
View Images thumbnail screen View Image screen View Image screen with image meta data

The application window lets you select an image from grid view by tapping to display image in full screen. The meta data of the displayed image is shown by default which can be toggled by tapping on the image screen area.

Sound Effects

This part of application showcases the following key features of multimediakit ( sound effects ) APIs.

  • sound effects API usage
  • play a sound files
Play sound effects screen

The application window will let you play a default sound effect for a selected repeats ( default 1 ). The repetitions can be increased on decreased by tapping on the respective buttons on the application screen. The minimum repetition count is by default set to 1.

Record Audio

This part of application showcases the following key features of multimediakit ( sound effects ) APIs.

  • record audio from microphone
  • play back recorded audio
Audio Recorder initial screen Audio Recorder recording screen Audio Recorder paused screen Audio Recorder play screen

The application window will let you record audio from device microphone and playback the stream. The recordings are saved to MyDocs/recordings on the device file system.

Capture Image

This part of application showcases the following key features of multimedia ( camera ) APIs.

  • use camera viewfinder for camera UI
  • capture images
  • select among various camera properties like flash and scene modes
  • view captured image
Camera view finder and capture screen Camera snapshot screen

The application window will let you capture pictures of predefined resolution from main camera with possibility to chose among camera properties like flash and scene modes. The captured picture is shown in full screen until back button is tapped to resume to view finder window.

Internet Radio

This part of application showcases the following key features of QML Audio, GStreamer, Events Feed and Notification APIs.

  • Retrieve audio stream information
  • Play, pause and resume Internet radio streams
  • Record Internet radio stream
  • Mark/Unmark Internet radio channels as favorites
Internet radio main screen Add Internet radio station screen Internet radio stations list screen Internet radio streaming screen Internet radio recording screen Internet radio recording save screen

The application window will let you add Internet radio stations and display its meta data when being played. The application also provides ability to record Internet radio stream and also save channels as favorites.

System Information

This part of application showcases the following key features of system information APIs which can be used to access various information of the device.

  • battery information
  • device information
  • display information
  • general information
  • network information
  • storage information
  • system state information
  • time settings information
System Information screen System Information screen System Information screen

The application window will let you know hardware and software capabilities, current states and various other information reflected on the device. The initial window shows the list of information that can be browsed by tapping on the respective item and then navigate across by flick gestures.

Accelerometer, Taps

This part of application showcases the following key features of accelerometer and tap sensor APIs.

  • Accessing realtime X, Y and Z axis readings from accelerometer sensor
  • Accessing realtime tap sensor readings
Initial accelerometer taps application screen Recording accelerometer sensor readings screen Recording save screen

The application window displays the real time readings of X, Y and Z axis from accelerometer sensor. The UI utilizes a graphical ball that moves around the screen showcasing how the sensor readings can be used by developers. The application also showcase usage of Tap sensor readings whenever the graphical ball touches edges of the screen. The record button enables application to save accelerometer sensor readings to a file saved in folder MyDocs/sensorReadings.

Ambient Light, Proximity, Orientation

This part of application showcases the following key features of ambient light, proximity and orientation sensor APIs.

  • accessing realtime device orientation
  • accessing realtime proximity to device
  • accessing realtime light level detected by device
Ambient, Proximity, Orientation Sensors screen Ambient, Proximity, Orientation Sensors screen

The application window shows the current ambient light level and proximity level readings from respective sensors when an object is close to sensors located at top the device ( also an indicator is shown in application window ). The application window orientation is respectively updated to match device orientation sensor reading and also the current orientation can be heard by tapping on icon located next to orientation text.

Compass, Rotation

This part of application showcases the following key features of compass and rotation sensor APIs.

  • accessing realtime compass reading
  • accessing realtime rotation sensor reading
Compass, Rotation Sensors screen

The application window graphically shows the current compass reading with a compass dial on camera view finder background. The readings of compass azimuth and calibration level along with rotation sensor reading are displayed at top of application window.