QFeedbackFileEffect Class Reference

Detailed Description

The QFeedbackFileEffect class allows to play feedback from a file.

Several different mime types may be supported on a system, including both haptic data files, and audio files.

The files containing haptics data are usually suffixed .ifr. The feedback is usually varying in intensity(), and is for that reason often referred to as a "haptic tune". They are created, for instance, from music files where the feedback is based on a specific feature in the audio data. For example, you could have a phone vibrating along with the bass of a rock song.

Although Qt Mobility does not let you record .ifr files, it lets you play them back using the QFeedbackFileEffect class. Setting up a QFeedbackFileEffect and starting it is done as follows:

 QFeedbackFileEffect hapticTune;
 hapticTune.setSource(QUrl::fromLocalFile("mySavedRumble.ifr"));
 hapticTune.load();
 hapticTune.start();

As with other QFeedbackEffects, QFeedbackFileEffect is at any given time in one of four states: Loading, Running, Paused, or Stopped. You request state changes with start(), pause(), and stop().

You can load() and unload() the file at will to free resources or be as fast as possible. The file must be loaded before it can be started, and it cannot be unloaded while playing. After the file is loaded, you can query its duration(). Some mime types may not support duration information - in these cases, 0 will be returned.

QFeedbackFileEffect reports errors through the error() signal.