MediaKeyWatcher

If two MediaKeyWatcher objects reference the same MediaKey then the last one to connect the signal will receive the notification until all the slots are disconnected from that signal. A short press is defined as being less than 650ms in duration and a long press is 650ms or greater in duration.

There are two different notification types for this media key watcher. MediaKeyNotification.Clicked is the default and results in the respective press signals to be called when the hardware media key is released. MediaKeyNotification.Threshold causes press to be signaled once the earliest connected signal threshold is reached (0ms for shortPress and 650ms for longPress). If both shortPress and longPress are connected the shortPress signal will only be emitted.

When all slots are disconnected from a signal, notification is returned to the last MediaKeyWatcher object that is connected to the signal of the same media key. Otherwise the default action from now playing is triggered.

C++ example:

MediaKeyWatcher keyWatcher(MediaKey::VolumeUp);
...
QObject::connect(&keyWatcher, SIGNAL(longPress(bb::multimedia::MediaKey::Type)), this, SLOT(onLongPress());
QObject::connect(&keyWatcher, SIGNAL(shortPress(bb::multimedia::MediaKey::Type)), this, SLOT(onShortPress());

QML example:

import bb.multimedia 1.0
...
attachedObjects: [
  MediaKeyWatcher {
      id: keyWatcher
      key: MediaKey.VolumeUp

      onLongPress: {
        // do something
      }

      onShortPress: {
        // do something
      }
  }
]