Sample apps

BBM: Contacts

Access contacts

The BBM Contacts example demonstrates how to register an application with the BlackBerry Messenger Social Platform and access the user's BBM contacts (who also have the application installed).

BBM: Invite to Download

Download this!

The BBM InviteToDownload example demonstrates how to send an "Invite to Download" message for an application through the BBM Social Platform.

BBM: Profile

Determine user profile information

The BBM Profile example demonstrates how to retrieve and modify your user profile from the BBM Social Platform.

BBM: Profile Box

Use the Profile Box

The BBM Profile Box example demonstrates how to create and update the Profile Box for the application shown in the user's BlackBerry Messenger profile using the Qt style BBM Social Platform library.

BBM: Registration

Register an application

The BBM Registration example demonstrates how to register an application with the BBM Social Platform.

Invoke Client

Invoke external applications

The Invoke Client example allows the user to invoke external applications in different ways.

Invoke Target

Handle incoming invocation requests

The Invoke Target example shows how to handle incoming invocation requests from other applications.

PIM Accounts

Perform simple account management

The PIM Accounts example is a simple account management application to list, view, edit, and delete the accounts available on the device, or create new accounts.

PIM Address Book

View and edit contacts

The PIM Address Book example is a simple address book application to list, view, edit, and delete the contacts available on the device, or create new contacts.

PIM Calendar

View and edit calendar events

The PIM Calendar example is a simple calendar application to list, view, edit, and delete the events available on the device, or create new events.

PIM Messages

View and send messages

The PIM Messages example is a simple messenger application to list, view, reply to, and delete the messages available on the device, or compose new messages.

PIM Notebook

View and edit notebook entries

The PIM Notebook example is a simple notebook application to list, view, edit, and delete the notes available on the device, or create new notes.

Scoreloop Integration

Get connected

Set up and integrate Scoreloop into the event system of your application by using BlackBerry Platform Services (BPS).

SmartSignals

Receive events from the BPS C library

This sample shows how the AbstractBpsEventHandler interface can be extended to receive BlackBerry Platform Services (BPS) events without needing to create a separate thread. These events are then made accessible to the QML layer by creating and registering a C++ class, BPSMonitor, so it is known to QML. After registering this type, you can then register to receive various events right from QML.

This sample can be tested either on a physical device or using the BlackBerry 10 Device Simulator in conjunction with controller.exe, which can be used to perform sensor manipulations.

Social Invocation

Use social networks

The Social Invocation example demonstrates how to integrate your application with various social networks using BlackBerry 10.

Twitter Timeline

Manage RESTful communication

This sample shows how to access a RESTful service that responds with JSON data and then display the results on the screen. It access the Twitter API to display a list of tweets.

In this sample, you will learn to:

• Make HTTP calls to a REST API
• Parse JSON responses using the JsonDataAccess class
• Use a ListView with a StandardListItem
• Use a ListView with a customized ListItemProvider

Data manager usage

Manage data source for ListView

The Data Manager example shows how the user can make use of the provided default query classes for loading data sources to the ListView. The difference between using these and writing your own DataModel is that they make use of a cache manager in combination with integrated options which improve the speed and efficiency of the query results. This in turn allows for the smooth scrolling of the ListView when dealing with large amounts of data.

Database Creation

Create SQL databases

The Database creation example demonstrates how to create a database, table and table records using the \c SqlQuery instance.

Database CRUD

Manage records with SQL

The Database CRUD example demonstrates how to create, read, update and delete records from a database table using the \c SqlDataAccess instance.

File Picker

Display a custom file dialog box

The File Picker example lets the user configure the properties of a file dialog and open it to select a file for loading or saving.

JSON Read and Write

Work with JSON data

The JSON Read and Write example shows how to use the JsonDataAccess class from the libbbdata library to convert between JSON formatted data and standard Qt value types.

List decorators

Modify data in model

The List Decorators example shows how the user can extend the behaviour and enhance the appearance of ListView by extending and implementing additional functionality in the DataModel/DataQuery decorators.

Persistent Objects

Make data persistent

The Persistent Objects example demonstrates the various stages (create-load-write-update) of a persistent object that can be saved either to a file or to a QSettings object.

RSS News

Fetch and show RSS feed data

The RSS News example demonstrates how to extract and display data from RSS news feeds from the network.

SOAP XML

Use SOAP web services

The SOAP XML example demonstrates how to retrieve weather information from a SOAP-based web service.

Accelerometer

Detect device movements

Retrieve accelerometer data, such as the azimuth, pitch, and roll of the device in G forces.

Go to the recipe ›

Battery

Know thy (battery) power

The Battery example demonstrates how to retrieve battery information, such as the battery charge level and its charging state.

Bluetooth GATT

Use the Bluetooth low-energy profile

The Bluetooth GATT example demonstrates how to use the Bluetooth functionality provided in BlackBerry 10 to retrieve information from Bluetooth devices that offer the low-energy profile.

Bluetooth SPP Chat

Pair devices

The Bluetooth SPP Chat example demonstrates how to use the Bluetooth functionality provided in BlackBerry 10. The user can retrieve information about the Bluetooth adaptor of the local device, list all paired and discovered remote devices, view the services provided by the remote devices, and start a chat session with remote devices using SPP.

Call a Pizza

Make a call to a pizzeria

The Call a Pizza example allows the user to look up the name and phone number of pizzerias in a certain region of the United States by entering a zip code. The results are displayed in a list, from which the user can invoke the phone dial pad directly for the selected phone number.

Channels

Send information to other threads

Communicate between threads by sending events through channels.

Gestures

Handle touch screen input

Capture and process screen gestures such as tap, double-tap, and pinch.

Go to the tutorial ›

HTTP Proxies

Gather proxy information

Retrieve the proxy information of the device that was set by the user.

Keyboard

Handle virtual keyboard input

Capture and process input from the virtual keyboard.

Go to the tutorial ›

LED

Use the LED for notifications

The LED example demonstrates how to manipulate the LED on the device using various colors and flash counts.

Network Status

Determine network connections

Retrieve the network status of the device.

Go to the recipe ›

NFC MAC Address

Show a MAC address

The NFC MAC Address example displays the MAC address of the sender device when receiving data using NFC.

NFC Receiver

Read data from NFC tags

The NFC Receiver example allows the user to read data from NFC tags.

NFC Sender

Send content using NFC

The NFC Sender example allows the user to send content to another NFC enabled device.

NFC Share

Exchange content using NFC

The NFC Share example allows the user to exchange content, such as messages or files, with another NFC enabled device.

Push Collector

Receive push data on a device

The Push Collector example demonstrates how to receive push data from a BlackBerry push initiator.

Sensors: Accel. Game

Handle device motion

The Sensors: Accel. Game example demonstrates how to use sensors from the QtSensors module to move a player through a maze.

Sensors: Compass

Show your direction

The Sensors: Compass example demonstrates how to use sensors from the QtSensors module to implement a compass UI.

Sensors: Demo

Explore the various device sensors

The Sensors: Demo example is a collection of pages where each page demonstrate how to retrieve and process data from a certain hardware sensor.

Sensors: Image Rotation

Keep an object straight

The Sensors: Image Rotation example demonstrates how to use sensors from the QtSensors module to always show an image upright on the screen, independent of the current device orientation.

Sensors: Orientation

Determine orientation

The Sensors: Orientation example demonstrates how to use sensors from the QtSensors module to find out about the current orientation of the device.

Sensors: Toss Game

Play a sensor game

The Sensors: Toss Game example demonstrates how to use sensors from the QtSensors module to trigger gesture switches in a simple rock-paper-scissors game.

Belligerent Blocks

Write a 2-D game

This game demonstrates rendering 2-D graphics, rendering text, integrating with Scoreloop, playing sound effects, using Box2D, and more!

Gamepad

Provide controller support

Capture and process game controller and joystick events over Bluetooth.

Go to the tutorial ›

Falling Blocks

Learn display and input handling basics

This sample demonstrates how to add blocks to the screen and move them using touch, accelerometer, and orientation change handling.

Go to the tutorial ›

Dialogs

Present information to your users

Configure and display a system dialog in your application using the dialog API.

Go to the recipe ›

Rotating Cube

Create a cube that rotates in 3-D

This sample demonstrates how to set up BlackBerry Platform Services (BPS), Screen, and EGL to display a 3-D rotating cube.

Go to the tutorial ›

Text Rendering

Draw custom text strings

Render a customized "Hello world" message to the screen.

Custom MapView

Create map controls

The Custom MapView example displays a city map overlayed with three sliders that allow you to control altitude, tilt, and heading. It also demonstrates how to put an overlay on another control and draw controls on top of that.

Geolocation

Find the location of the device

Retrieve geolocation data, such as the latitude, longitude, altitude, and bearing of the device.

Go to the recipe ›

Location Diagnostics

Retrieve positions

The Location Diagnostics example allows the user to configure a geo position source and retrieve information from it, either one-time or continuously.

Map Animations

Animate a map's viewport

The Map Animations example demonstrates how to use the Qt easing curves to animate the map's viewport.
You will learn how to:

• Use the MapView class.
• Work ActionItems
• Use property animations

MapView

Handle maps and drop pins

The MapView example displays a city map overlayed with three sliders that allow you to control altitude, tilt, and heading. It also demonstrates how to drop push pins on chosen locations.

Place Picker

Pick a place, any place!

The Place Picker example allows the user to view the properties (such as name, postal address, or phone number) of a place that they select from the address book, recent history, or an online search.

Route Map Invoker

Get from A to B

The Route Map Invoker example allows the user to select a cinema from a list and invokes the navigation application to show the route from a fixed point to the selected cinema.

Web MapView

Access and view external maps

The Web MapView example lets the user browse maps from different providers (Google, Bing, and OpenLayers), put pins on the map at the current location, clear all pins from the map, and switch between different view modes (road, satellite, hybrid, and so on).

App Shot

Take a screen shot of your app

This small sample illustrates how to take programmatic screen shots of your running app. It contains AppShot, which is a helper class that lets you perform this from QML.

Audio Settings

Retrieve audio control information

Query the device for audio control settings, such as headphone volume, speaker volume, input gain, and mute status.

Go to the recipe ›

Barcode Reader

Scan and decode QR codes

The Barcode Reader example allows the user to scan a QR code with the camera and view the decoded textual representation.

Camera

Use the camera on the device

Access the camera, take a photo, and save the photo to the camera roll.

Custom Barcode Invoker

Issue scan requests

The Custom Barcode Invoker example allows the user to scan barcodes using a card through the InvokeManager by issuing scan requests.

Barcode Scanner

Scan QR codes

The Custom Barcode Scanner example allows the user to scan a QR code with the camera and view the decoded textual representation.

Dictaphone

Record audio and play it back

The Dictaphone example simulates an analog dictaphone. It allows you to record some voice audio, pause the recording, and play it back later on. You can also record multiple tracks in a sequence.

Now Playing

Show what you're hearing

The Now Playing example demonstrates how to use the multimedia framework in BlackBerry 10. It provides extended information in the UI about the media currently being played and it lets the user control the media player with hardware keys.

Play a Video

Configure and use the multimedia renderer

This sample demonstrates how to use the multimedia renderer library to play a video on the screen. Currently, this sample works only on a device, not on the BlackBerry 10 Device Simulator.

Go to the tutorial ›

Play .mp3

Load and play an .mp3 file

Play and adjust volume for a simple .mp3 file using the multimedia renderer and the audio mixer.

Play .wav

Process and play a .wav file

Open, determine properties of, and play a .wav file using the libasound library.

Go to the tutorial ›

Scratch Pad

Replicate using rows and columns

The Scratch Pad example demonstrates how to take a geometrical shape or image and replicate it, using N rows and M columns to produce a new resulting image based on N*M.

System Sound

Test event sounds on the device

The System Sound example demonstrates how to play system sounds that are included in the BlackBerry 10 OS, such as the low battery warning and the camera shutter sound.

Video Overlay

Display video playback controls

Use gestures and OpenGL ES to show and hide controls for video playback.

Advertising Service

Generate ad revenue

Create ad banners and display advertisements in the browser using the Advertising Service.

Go to the tutorial ›

Banner Ads

Integrate ads and generate revenue

The Banner Ads example demonstrates how to connect to the Advertising Service and display advertisement banners in your app. These banners reflect the specific settings you have chosen in the Advertising Service portal and allow you to track ad performance metrics.

BPS to QML

Expose BPS in QML

The Bps to qml example demonstrates how to expose bps events to qml, by requesting events for various modules that you want to listen in on and emitting module specific signals when the event arrives in order to notify the qml context of it. This allows the qml side decide how it wants to act based on the data provided by the signal; this, more closely follows the MVC pattern of design.

Dialogs

Show informative messages

The Dialogs example demonstrates how to use various dialog boxes to display notifications to the user.

Good Citizen

Learn app design basics

Learn about common techniques that you can use in your own applications, such as screen events, navigator events, data updates, and scene rendering.

Go to the tutorial ›

Headless service

Headless service

In this example we'll learn how to create a long-running headless service.
WARNING: This is not a standalone sample, and should not be deployed to device directly. It is used (packaged) in the headlesserviceui sample bar file as a captive library. If deployed directly, it will prevent headlesserviceui from deploying it a second time, meaning that you might experience faulty app behaviour.
Do not deploy this as a standalone sample.
You will learn:

• How to create a long-running background service and launched via system startup.
• How to communicate with it through the QSettings instance. This is only one of many communication choices (ie. sockets, pps service, etc).

Headless service UI

Headless service

In this example we'll learn how to create a UI app that communicates with a long-running headless service in the background.
Note: This sample requires the headlesservice code to be synced and build inthe same location as headlesserviceui since they are relative to one anothers location. This has to be done prior to deploying headlesserviceui , otherwise it will fail at the packaging stage due to missing headlesservice binary. The reason being is that this sample packages headlesservice in the same bar file. Do not try to deploy headlesservice as a standalone sample, it could cause some headlesserviceui sample functionality badness.
Do not deploy headlesservice as standalone sample.
You will learn:

• How to launch background service at system startup or first installation and communicated with that service using QString instance.

HTTP Test

Communicate with the web

The HTTP Test example demonstrates how to retrieve data from, or send data to, an HTTP service.

Identity Service

Personalize with user information

Personalize your app with information from the user's BlackBerry ID account using the Identity Service. This app introduces you to common development practices related to the Identity Service that you can use in your own applications.

Go to the API reference ›

Identity Service C++

Using IDS in C++

Personalize your app with information from the user's BlackBerry ID account using the Identity Service. This app introduces you to common development practices related to the Identity Service that you can use in your own applications.

This sample is created in C++.

Go to the API reference ›

Identity Service QML

Using IDS in QML

Personalize your app with information from the user's BlackBerry ID account using the Identity Service. This app introduces you to common development practices related to the Identity Service that you can use in your own applications.

This sample is created in QML.

Go to the API reference ›

Locale

Detect country and language

Retrieve the country and language settings for the device.

Go to the recipe ›

Notifications

Show messages in the BlackBerry Hub

The Notifications example demonstrates how to use the notification framework in BlackBerry 10 to inform the user about certain events.

Payment Service

Use in-app purchases

The Payment Service example demonstrates how to use Cascades and the Payment Service to sell digital goods in your app. It also displays the history of purchases and subscription terms, allowing you to monetize your application content.

Payment Service

Sell digital goods

Create purchase requests, handle purchase responses, and retrieve existing purchases using the Payment Service.

Go to the recipe ›

XandOs

Headless service

The XandOs example demonstrates how to launch a headless service counterpart and communicate with it. In this sample, we represent the game board using an image and sprites for the game pieces.

XandOs droid

Headless service

The XandOsDroid example demonstrates how to create a headless service and communicate with it's UI counterpart. Make note that this is NOT a standalone, independantly deployable application, it is packaged with xandos sample and deployed via it's bar file.

Bucket List

Create a multi-select list

BfB-Showcase

Built for BlackBerry showcase

Cascades Cookbook

See core UI controls

Circular Slider

Implement your own custom control

Cowbell

Play a basic sound using OpenAL

Filtered DataModel

Filter your data

Hello Cascades

Use your first text and image

Hello Foreign Window

Display foreign content

Image loader

Implement worker threads for tasks

Kakel

Design a puzzle game with a dynamic UI

Lightning Crossfade QML

Use a slider in QML

Lightning Crossfade C++

Use a slider in C++

Loader

Load and unload UI controls

Paged DataModel

Reload your data

Photo Bomber

Camera

The PhotoBomber is a camera application that lets you take photos and then have them "bombed" by another image that jumps in, automatically.

You will learn to:

• Use the Cascades multimedia library with the camera
• Take a picture
• Manipulate the image to be grayscale
• Add an image over another image

Poem Maker

Explore animations using poetry

Pull My Beard

Handle touches and drag-and-drop

Quotes

Display a list and access SQL data

Repeater

Load and unload parameterized controls

Speed Writer

Test your typing speed using a custom control

Stamp Collector

Populate a list with JSON data

Starship Settings

Store persistent data

Vegetables DataModel

Arrange your data

Weather guesser

Create tabs and panes

Shared Memory

Use inter-process communication (IPC)

The Shared Memory example shows how to use the QSharedMemory class to implement inter-process communication using shared memory.

Sharedmemory loader

Use more IPC

The Shared Memory Loader example shows how to use the QSharedMemory class to implement inter-process communication using shared memory.

Broadcast Receiver

Receive broadcasts

The Broadcast Receiver example shows how to receive information that is broadcasted over a local network.

Broadcast Sender

The Broadcast Sender example shows how to broadcast information to multiple clients on a local network.

Download Manager

Queue downloads

The Download Manager example shows how to implement a queue for multiple downloads using the QNetworkAccessManager class.

Google Suggest

Receive a list of typing suggestions

The Google Suggest example demonstrates how to use the QNetworkAccessManager class to obtain a list of suggestions from the Google search engine as the user types into a TextField.

HTTP

Implement an HTTP client

The HTTP example demonstrates a simple HTTP client that shows how to fetch files specified by URLs from remote hosts.

Multicast Receiver

Receive a multicast

The Multicast Receiver example shows how to receive information that is sent to a multicast group.

Multicast Sender

Send a multicast

The Multicast Sender example shows how to send information to multiple clients in a multicast group.

QFTP

Implement an FTP client

The QFTP example demonstrates a simple FTP client that can be used to list the available files on an FTP server and download them.

Secure Socket Client

Talk using SSL

The Secure Socket Client example shows how to use QSslSocket to communicate over an encrypted (SSL) connection. It also demonstrates how to deal with authenticity problems, and how to display security and certificate information.

The screen shot on the left shows a connection established with a web server. The string "GET" was sent.

Progress Dialog

Monitor a lengthy operation

The QtConcurrent Progress Dialog example shows how to use the QFutureWatcher class to monitor the progress of a long-running operation.

Word Count

Count items more efficiently

The QtConcurrent Word Count example demonstrates the use of the map-reduce algorithm when applied to the problem of counting words in a collection of files.

Script Game

Enhance your apps using scripting

The Script Game example shows how to extend a C++ application with scripting functionality.

Grue Detector

Prevent unfortunate Grue incidents

The Grue Detector example demonstrates how to use sensors from the QtSensors module to warn you about the chance of being eaten by a Grue.

Sensor Explorer

Take a tour of available sensors

The Sensor Explorer example demonstrates how to introspect all available sensors of a device.

SQL Widget Mapper

Map SQL data

The SQL Widget Mapper example shows how to use a DataControlMapper to map information from a database to controls in a form.

Factorial States

Calculate factorials with a state machine

The Factorial States example shows how to use the State Machine Framework to calculate the factorial of an integer.

Ping Pong States

Use parallel states

The Ping Pong States example shows how to use parallel states together with custom events and transitions in the State Machine Framework.

Traffic Light

Control traffic with a state machine

The Traffic Light example shows how to use the State Machine Framework to implement the control flow of a traffic light.

Queued Custom Type

Send between threads

The Queued Custom Type example shows how to send custom types between threads with queued signals and slots.

Semaphores

Control access using semaphores

The Semaphores example shows how to use QSemaphore to control access to a circular buffer shared by a producer thread and a consumer thread.

Wait Conditions

Control access using conditions and mutex

The Wait Conditions example shows how to use QWaitCondition and QMutex to control access to a circular buffer shared by a producer thread and a consumer thread.

Codecs

Import text properly using codecs

The Codecs example demonstrates the principles behind importing text using codecs to ensure that characters are encoded properly, avoiding loss of data and retaining the correct symbols used in various scripts.

Contiguous Cache

Manage large models

The Contiguous Cache example shows how to use QContiguousCache to manage memory usage for very large models.

i18n

Provide translation support

The Internationalization (I18N) example demonstrates Qt's support for translated text. Developers can write the initial application text in one language, and translations can be provided later without any modifications to the code.

Regexp

Apply regular expressions to text

The Regular Expressions (RegExp) example shows how regular expressions in Qt are applied to text by providing an environment in which new regular expressions can be created and tested on custom text strings.

Undo Framework

Correct your mistakes

The Undo Framework example shows how to implement undo/redo functionality with the Qt undo framework.

DOM Bookmarks

Parse XML data

The DOM Bookmarks example provides a parser and generator for XML Bookmark Exchange Language (XBEL) files that uses Qt's DOM-based XML API to read and parse the files. The SAX Bookmarks example provides an alternative way to read this type of file.

XML HTML Info

Get information about HTML content

The XML HTML Info example provides statistics about the content of HTML files.

RSS-listing

Retrieve items from RDF sources

This example shows how to create a UI that displays news items from RDF news sources.

SAX Bookmarks

Use SAX-based APIs to parse files

The SAX Bookmarks example provides a reader for XML Bookmark Exchange Language (XBEL) files that uses Qt's SAX-based API to read and parse the files. The DOM Bookmarks example provides an alternative way to read this type of file.

QXmlStream Bookmarks

Stream XML data

The QXmlStream Bookmarks example provides a reader for XML Bookmark Exchange Language (XBEL) files using Qt's QXmlStreamReader class for reading, and QXmlStreamWriter class for writing the files.

XML Stream Lint

The XML Stream Lint example provides a simple UI to select an XML file that gets validated.