Changes between Version 8 and Version 9 of APS

Timestamp:

Mar 13, 2009 12:38:31 PM (15 years ago)

Author:

nanang

Comment:

Updated parts related to the new audio dev API.

APS

@@ -21 +21 @@
     - [http://www.forum.nokia.com/info/sw.nokia.com/id/4ff42a22-7099-4cc9-91bf-5e66166bd28d/S60_3rd_SDK_FP1_API_Plug-In_Pack.html APS for FP1]
     - we're not sure how APS should work for FP2
- 2. You may also need [http://www.forum.nokia.com/info/sw.nokia.com/id/48a93bd5-028a-4b3e-a0b1-148ff203b2b3/Extensions_plugin_S60_3rd_ed.exe.html Extensions plug-in for S60 3rd Edition SDK for Symbian OS for C++ MR] to get '''sounddevice.h'''.
+ 2. MMF !DevSound API (i.e.: to get {{{sounddevice.h}}}):
+    - for S60 3rd edition MR, it can be found in [http://www.forum.nokia.com/info/sw.nokia.com/id/48a93bd5-028a-4b3e-a0b1-148ff203b2b3/Extensions_plugin_S60_3rd_ed.exe.html Extensions plug-in for S60 3rd Edition SDK for Symbian OS for C++ MR].
+    - for S60 3rd edition FP1 & FP2, it is bundled in the SDK API Plug-in above.
  3. You need a '''Symbian Developer Certificate''' of type Open Signed Offline and with valid Publisher ID to install the application that uses APS on the device. APS requires '''MultimediaDD''' capability and this capability is among the restricted capabilities so the application needs to be signed with a valid developer certificate to use the capability. The signing options for applications that need these restricted capabilities are Open Signed Offline or Certified Signed. Please see [http://www.symbiansigned.com Symbian Signed website] for more detail.
 
@@ -32 +34 @@
 #endif
  }}}
+    '''Update''': for trunk version (with the '''new audio device API'''), macro PJMEDIA_SOUND_IMPLEMENTATION is deprecated, so it should be defined as:
+ {{{
+#if defined(PJ_SYMBIAN) || PJ_SYMBIAN==1
+#   define PJMEDIA_AUDIO_DEV_HAS_SYMB_APS       1
+#endif
+ }}}
  1. Edit {{{bld.inf}}} and application's .mmp files (e.g: {{{symbian_ua.mmp}}}, {{{symbian_ua_gui.mmp}}}, {{{symsndtest.mmp}}}), and activate {{{SND_USE_APS}}} macro:
  {{{
@@ -38 +46 @@
 #define SND_USE_VAS     0
  }}}
-    '''Update''': for trunk version, {{{bld.inf}}} doesn't need to be edited.
+    '''Update''': for trunk version, {{{bld.inf}}} doesn't need to be edited, and the macro should be defined is {{{SND_HAS_APS}}}:
+ {{{
+#define SND_HAS_APS     1
+ }}}
  1. Refresh the makefiles:
     - If you are using Carbide, please refresh the project first (right click '''bld.inf''' from the '''Symbian Project Navigator''' pane, and select '''Refresh'''). '''symbian_audio_aps.mmp''' should be there after the refresh done.
     - If you are building from command line, use '''bldmake clean''' then '''bldmake bldfiles'''.
- '''Update''': for trunk version, {{{symbian_audio_aps.mmp}}} is no longer used, all symbian audio implementations are bundled in {{{symbian_audio.mmp}}}.
+ '''Update''': for trunk version, {{{symbian_audio_aps.mmp}}} is no longer used, all symbian audio implementations are bundled in {{{pjmedia_audiodev.mmp}}}.
  4. Clean and rebuild the whole project. Please note that WINSCW target doesn't seem to support APS.
  5. Make the installer (.sis file) for the application.