summaryrefslogtreecommitdiffstats
path: root/doc/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/classes/phonon-api.qdoc10
-rw-r--r--doc/src/platforms/platform-notes.qdoc25
2 files changed, 35 insertions, 0 deletions
diff --git a/doc/src/classes/phonon-api.qdoc b/doc/src/classes/phonon-api.qdoc
index 98df89d..641b936 100644
--- a/doc/src/classes/phonon-api.qdoc
+++ b/doc/src/classes/phonon-api.qdoc
@@ -1651,6 +1651,16 @@
playback of the current source, but it is possible to try with a
different one. A user readable error message is given by
errorString().
+ \section1 Symbian Platform Security Requirements
+
+ On Symbian, processes which access media via the network must
+ have the \c NetworkServices platform security capability. If the client
+ process lacks this capability, operations will result in errors.
+ This failure is indicated by a state() of Phonon::ErrorState.
+
+ Platform security capabilities are added via the
+ \l{qmake-variable-reference.html#target-capability}{TARGET.CAPABILITY}
+ qmake variable.
\sa Phonon::MediaSource, Phonon::AudioOutput, VideoWidget,
{Music Player Example}, {Phonon Overview}, Phonon::VideoPlayer,
diff --git a/doc/src/platforms/platform-notes.qdoc b/doc/src/platforms/platform-notes.qdoc
index f513181..131d035 100644
--- a/doc/src/platforms/platform-notes.qdoc
+++ b/doc/src/platforms/platform-notes.qdoc
@@ -502,6 +502,31 @@
For information about mixing exceptions with Symbian leaves, see
\l{Exception Safety with Symbian}.
+ \section1 Required Capabilities
+
+ Distributions of Qt are typically signed with \c{All -TCB}. What your
+ application needs to be signed with in order to function with Qt depends
+ on what functionality it uses:
+
+ \table
+ \header \o Technology
+ \o Required Symbian Capability
+ \row \o QtCore
+ \o \c PowerMgmt if applications are terminated using QProcess.
+ \row \o QtNetwork
+ \o NetworkServices
+ \row \o QtMultiMedia
+ \o \c UserEnvironment if QAudioInput is used.
+ \endtable
+
+ Depending on what file paths that are accessed and how AllFiles may be
+ required. Similarly, if the network is accessed indirectly through
+ components such as QtXmlPatterns, QtWebkit or QtScript, the capabilities
+ needs to match accordingly.
+
+ See individual classes' documentation for specifics. If a class does not
+ mention Symbian capabilities, it requires none.
+
\section1 Multimedia and Phonon Support
Qt provides a backend for Qt's Phonon module, which supports