×
Namespaces

Variants
Actions
(Difference between revisions)

SDK API Plug-in

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Automated change of text from {{NoteS}} to {{Note|. (Using Template:Note now))
hamishwillee (Talk | contribs)
m (Hamishwillee - Adding missing translation link)
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Symbian C++]]
+
{{ArticleMetaData <!-- v1.2 -->
__NOEDITSECTION__
+
|sourcecode= [[Media:SIMUtilsAPI 3x 50.zip]] [[Media:S60 3rd ed fp1 api plug-in pack supplementary.zip]] [[Media:S60 3rd ed fp2 api plug-in pack supplementary.zip]] [[Media:S60 5th ed api plug-in pack supplementary.zip]]
__FORCETOC__
+
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
+
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
As a response to the frequent requests expressed by the 3rd party developers for more internal APIs to be released, Forum Nokia is providing the [[S60 API Partnering Program|S60 API Partnering]] process through which any developer can apply for access to the APIs needed to implement a given functionality. Whether the request is approved or not it all depends on the business justification provided and the current status of the APIs ( binary compatibility breaks, API deprecation, security considerations ... )
+
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
 +
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 +
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate= 20070616
 +
|author= [[User:Ltomuta]]
 +
}}
 +
[[Category:Symbian C++]][[Category:SDK]]
 +
As a response to the frequent requests expressed by the 3rd party developers for more internal APIs to be released, Nokia Developer is providing the [[Accessing internal platform APIs through the API Partnering Program]] process through which any developer can apply for access to the APIs needed to implement a given functionality. Whether the request is approved or not it all depends on the business justification provided and the current status of the APIs ( binary compatibility breaks, API deprecation, security considerations ... )
  
 
The receiver of the API should understand that despite the initial testing, which is intended to show that the API works on the targeted device, no guarantees can be given with regards to the binary compatibility or the availability of the API across platform version or even within devices released based on the current platform version.
 
The receiver of the API should understand that despite the initial testing, which is intended to show that the API works on the targeted device, no guarantees can be given with regards to the binary compatibility or the availability of the API across platform version or even within devices released based on the current platform version.
Line 10: Line 29:
  
 
The following very important message accompanies the plug-in and is also included in each API's release notes, please read carefully:  
 
The following very important message accompanies the plug-in and is also included in each API's release notes, please read carefully:  
 
+
{{Warning|PLEASE NOTICE THE FOLLOWING ISSUES WITH THESE APIs:
 
+
<HR>
+
PLEASE NOTICE THE FOLLOWING ISSUES WITH THESE APIs:
+
 
#Nokia is not giving any binary compatibility promise for these APIs; neither between platform versions or within a platform version.
 
#Nokia is not giving any binary compatibility promise for these APIs; neither between platform versions or within a platform version.
#You must test your application with each device that the application can be installed on. This is needed to ensure the best possible user experience. To prevent application installation on other than tested devices, define the Product ID(s) (also known as Machine UID) in the .pkg file. More information can be found in the document [http://www.forum.nokia.com/info/sw.nokia.com/id/8731ef95-05d5-4596-844f-ebe326e16127/S60_Platform_Identification_Codes_v1_9_en.pdf.html S60 Platform: Identification Codes] available on the Forum Nokia Web site.
+
#You must test your application with each device that the application can be installed on. This is needed to ensure the best possible user experience. To prevent application installation on other than tested devices, define the Product ID(s) (also known as Machine UID) in the .pkg file. More information can be found in the document [http://www.developer.nokia.com/info/sw.nokia.com/id/8731ef95-05d5-4596-844f-ebe326e16127/S60_Platform_Identification_Codes_v1_9_en.pdf.html S60 Platform: Identification Codes] available on the Nokia Developer website.
<HR>
+
}}
 
+
 
+
  
 
The API plug-in package is also covered by a click through Limited License Agreement (LLA), the content of which is also included in the package. The use of the API included in the API Plug-in assumes that the LLA is implicitly accepted.
 
The API plug-in package is also covered by a click through Limited License Agreement (LLA), the content of which is also included in the package. The use of the API included in the API Plug-in assumes that the LLA is implicitly accepted.
 
+
{{Note|The content of the Limited License Agreement (LLA) has been updated to address the concerns regarding the usage of the API in 3rd Party projects.}}
{{Note|
+
{{Note|The latest version of the VoIP Audio Services API device binaries (SIS file) can now be found through [[VoIP Audio Service API | API's page in this wiki]].}}
:The content of the Limited License Agreement (LLA) has been updated to address the concerns regarding the usage of the API in 3rd Party projects.
+
}}
+
 
+
{{Note|
+
:The latest version of the VoIP Audio Services API device binaries (SIS file) can now be found through [[VoIP Audio Service API | API's page in this wiki]].
+
}}
+
 
+
  
 
Currently the following API Plug-in packages are available:
 
Currently the following API Plug-in packages are available:
  
=API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, MR=
+
== S60 3rd Edition SDK, MR (Symbian C++) ==
  
*Package URL: [http://www.forum.nokia.com/info/sw.nokia.com/id/53439e01-f605-4491-96f4-62d003bd4c0c/S60_3rd_SDK_MR_API_Plug-In_Pack1.zip.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, MR]
+
*Package URL: [http://www.developer.nokia.com/info/sw.nokia.com/id/53439e01-f605-4491-96f4-62d003bd4c0c/S60_3rd_SDK_MR_API_Plug-In_Pack1.zip.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, MR]
 
*Current version: 5.43
 
*Current version: 5.43
 
*Included APIs: 41
 
*Included APIs: 41
 
  
 
The following APIs are included:
 
The following APIs are included:
 
+
{| class="wikitable"
:{|align=left
+
|[[Adaptive History List API]]
|width=40%|[[Adaptive History List API]]
+
|[[AIW Criteria API]]
|width=1%|
+
|-
|width=40%|[[AIW Criteria API]]
+
|[[AIW Generic Parameters API]]
|---
+
|[[AIW Service Handler API]]
|width=40%|[[AIW Generic Parameters API]]
+
|-
|width=1%|
+
|[[Audio Metadata Reader API]]
|width=40%|[[AIW Service Handler API]]
+
|[[Audio Proxy Server|Audio Proxy Server API]] v2.43 <span style="color:red">***</span>
|---
+
|-
|width=40%|[[Audio Metadata Reader API]]
+
|[[Bluetooth Engine API]]
|width=1%|
+
|[[Browser Launcher API]]
|width=40%|[[Audio Proxy Server|Audio Proxy Server API]] v2.43 <span style="color:red">***</span>
+
|-
|---
+
|[[Camera Application Engine API]]
|width=40%|[[Bluetooth Engine API]]
+
|[[CR Keys To Control Phone Volume API]]
|width=1%|
+
|-
|width=40%|[[Browser Launcher API]]
+
|[[Data Connection Log Counters API]]
|---
+
|[[Extended AIW Criteria API]]
|width=40%|[[Camera Application Engine API]]
+
|-
|width=1%|
+
|[[Extended Skins API]]
|width=40%|[[CR Keys To Control Phone Volume API]]
+
|[[Item Finder API]]
|---
+
|-
|width=40%|[[Data Connection Log Counters API]]
+
|[[KAccessoryModeChanged API]]
|width=1%|
+
|[[KAlarmClockOne API]]
|width=40%|[[Extended AIW Criteria API]]
+
|-
|---
+
|[[Archived:Setting various indicators on S60 3rd Edition FP2]]
|width=40%|[[Extended Skins API]]
+
|[[Logs Client API]]
|width=1%|
+
|-
|width=40%|[[Item Finder API]]
+
|[[Logs Timers API]]
|---
+
|[[Media Player Engine API]]
|width=40%|[[KAccessoryModeChanged API]]
+
|-
|width=1%|
+
|[[Media Recorder API]]
|width=40%|[[KAlarmClockOne API]]
+
|[[Meeting Request API]]
|---
+
|-
|width=40%|[[KCoreAppUIsNewEmailStatus API]]
+
|[[WLAN Management API]]
|width=1%|
+
|[[New File Service Client API]]
|width=40%|[[Logs Client API]]
+
|-
|---
+
|[[OMA Provisioning Adapter API]]
|width=40%|[[Logs Timers API]]
+
|[[Personalisation Skins Settings API]]
|width=1%|
+
|-
|width=40%|[[Media Player Engine API]]
+
|[[Phone Client Dial API]]
|---
+
|[[Phone Client Extension API]]
|width=40%|[[Media Recorder API]]
+
|-
|width=1%|
+
|[[Profiles Engine API]]
|width=40%|[[Meeting Request API]]
+
|[[Profiles Engine Extended API]]
|---
+
|-
|width=40%|[[WLAN Management API]]
+
|[[Profile UID API]]
|width=1%|
+
|[[PS Keys for Call Status %26 Indicators API|PS Keys for Call Status & Indicators API]]
|width=40%|[[New File Service Client API]]
+
|-
|---
+
|[[S60 RTP/RTC API]]
|width=40%|[[OMA Provisioning Adapter API]]
+
|[[ScShortcuts Engine Wrapper API]]
|width=1%|
+
|-
|width=40%|[[Personalisation Skins Settings API]]
+
|[[Shared Data API]]
|---
+
|[[SMS Utilities API]]
|width=40%|[[Phone Client Dial API]]
+
|-
|width=1%|
+
|[[SW Installer Launcher API]]
|width=40%|[[Phone Client Extension API]]
+
|[[SyncML Client API]]
|---
+
|-
|width=40%|[[Profiles Engine API]]
+
|[[WLAN Info API]]
|width=1%|
+
|[[WLAN Settings UI API]]
|width=40%|[[Profiles Engine Extended API]]
+
|-
|---
+
|[[PS Keys for WLAN API]]
|width=40%|[[Profile UID API]]
+
|
|width=1%|
+
|-
|width=40%|[[PS_Keys_for_Call_Status_%26_Indicators_API|PS Keys for Call Status & Indicators API]]
+
|---
+
|width=40%|[[S60 RTP/RTC API]]
+
|width=1%|
+
|width=40%|[[ScShortcuts Engine Wrapper API]]
+
|---
+
|width=40%|[[Shared Data API]]
+
|width=1%|
+
|width=40%|[[SMS Utilities API]]
+
|---
+
|width=40%|[[SW Installer Launcher API]]
+
|width=1%|
+
|width=40%|[[SyncML Client API]]
+
|---
+
|width=40%|[[WLAN Info API]]
+
|width=1%|
+
|width=40%|[[WLAN Settings UI API]]
+
|---
+
|width=40%|[[PS Keys for WLAN API]]
+
|width=1%|
+
|width=40%|
+
|---
+
 
|}
 
|}
  
  
  
<BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR>><BR><BR><BR><BR><BR><BR>
+
== S60 3rd Edition SDK, Feature Pack 1 (Symbian C++) ==
=API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1=
+
  
*Package URL: [http://www.forum.nokia.com/info/sw.nokia.com/id/4ff42a22-7099-4cc9-91bf-5e66166bd28d/S60_3rd_SDK_FP1_API_Plug-In_Pack.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1]
+
*Package URL: [http://www.developer.nokia.com/info/sw.nokia.com/id/4ff42a22-7099-4cc9-91bf-5e66166bd28d/S60_3rd_SDK_FP1_API_Plug-In_Pack.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1]
 
*Current version: 2.5
 
*Current version: 2.5
 
*Included APIs: 42
 
*Included APIs: 42
 
  
 
The following APIs are included:
 
The following APIs are included:
 +
{| class="wikitable"
 +
|[[Adaptive History List API for 3rd Edition Feature Pack 1]]
 +
|[[AIW Criteria API]]
 +
|-
 +
|[[AIW Generic Parameters API]]
 +
|[[AIW Service Handler API]]
 +
|-
 +
|[[Audio Metadata Reader API]]
 +
|[[Audio Proxy Server|Audio Proxy Server API]] v2.43 <span style="color:red">(deprecated),***</span>
 +
|-
 +
|[[Audio Routing API]]
 +
|[[Bluetooth Engine API]]
 +
|-
 +
|[[Browser Launcher API]]
 +
|[[CR Keys To Control Phone Volume API]]
 +
|-
 +
|[[Data Connection Log Counters API]]
  
:{|align=left
+
|[[Extended AIW Criteria API]]
|width=40%|[[Adaptive History List API for 3rd Edition Feature Pack 1]]
+
|-
|width=1%|
+
|[[Extended Skins API]]
|width=40%|[[AIW Criteria API]]
+
|[[Item Finder API]]
|---
+
|-
|width=40%|[[AIW Generic Parameters API]]
+
|[[KAccessoryModeChanged API]]
|width=1%|
+
|[[KAlarmClockOne API]]
|width=40%|[[AIW Service Handler API]]
+
|-
|---
+
|[[Archived:Setting various indicators on S60 3rd Edition FP2]]
|width=40%|[[Audio Metadata Reader API]]
+
|[[Logs Client API]]
|width=1%|
+
|-
|width=40%|[[Audio Proxy Server|Audio Proxy Server API]] v2.43 <span style="color:red">(deprecated),***</span>
+
|[[Logs Timers API]]
|---
+
|[[Media Player Engine API]]
|width=40%|[[Audio Routing API]]
+
|-
|width=1%|
+
|[[Media Recorder API]]
|width=40%|[[Bluetooth Engine API]]
+
|[[Meeting Request API]]
|---
+
|-
|width=40%|[[Browser Launcher API]]
+
|[[MMFDevSound API]]
|width=1%|
+
 
|width=40%|[[CR Keys To Control Phone Volume API]]
+
|[[Music Player Remote Control API]]
|---
+
|-
|width=40%|[[Data Connection Log Counters API]]
+
|[[New File Service Client API]]
|width=1%|
+
|[[OMA Provisioning Adapter API]]
|width=40%|[[Extended AIW Criteria API]]
+
|-
|---
+
|[[Personalisation Skins Settings API]]
|width=40%|[[Extended Skins API]]
+
|[[Phone Client Dial API]]
|width=1%|
+
|-
|width=40%|[[Item Finder API]]
+
|[[Phone Client Extension API]]
|---
+
|[[Profiles Engine Extended API]]
|width=40%|[[KAccessoryModeChanged API]]
+
|-
|width=1%|
+
|[[Profile UID API]]
|width=40%|[[KAlarmClockOne API]]
+
|[[PS Keys for Call Status & Indicators API]]
|---
+
|-
|width=40%|[[KCoreAppUIsNewEmailStatus API]]
+
|[[S60 RTP/RTC API]]
|width=1%|
+
|[[ScShortcuts Engine Wrapper API]]
|width=40%|[[Logs Client API]]
+
|-
|---
+
|[[Settings Framework API]]
|width=40%|[[Logs Timers API]]
+
|[[SMS Utilities API]]
|width=1%|
+
|-
|width=40%|[[Media Player Engine API]]
+
|[[SW Installer Launcher API]]
|---
+
|[[SyncML Client API]]
|width=40%|[[Media Recorder API]]
+
|-
|width=1%|
+
|[[WLAN Info API]]
|width=40%|[[Meeting Request API]]
+
|[[WLAN Management API]]
|---
+
|-
|width=40%|[[MMFDevSound API]]
+
|[[Call Audio Control API]] <span style="color:red">***</span>
|width=1%|
+
|[[VoIP Audio Service API]] <span style="color:red">***</span>
|width=40%|[[Music Player Remote Control API]]
+
|-
|---
+
|width=40%|[[New File Service Client API]]
+
|width=1%|
+
|width=40%|[[OMA Provisioning Adapter API]]
+
|---
+
|width=40%|[[Personalisation Skins Settings API]]
+
|width=1%|
+
|width=40%|[[Phone Client Dial API]]
+
|---
+
|width=40%|[[Phone Client Extension API]]
+
|width=1%|
+
|width=40%|[[Profiles Engine Extended API]]
+
|---
+
|width=40%|[[Profile UID API]]
+
|width=1%|
+
|width=40%|[[PS Keys for Call Status & Indicators API]]
+
|---
+
|width=40%|[[S60 RTP/RTC API]]
+
|width=1%|
+
|width=40%|[[ScShortcuts Engine Wrapper API]]
+
|---
+
|width=40%|[[Settings Framework API]]
+
|width=1%|
+
|width=40%|[[SMS Utilities API]]
+
|---
+
|width=40%|[[SW Installer Launcher API]]
+
|width=1%|
+
|width=40%|[[SyncML Client API]]
+
|---
+
|width=40%|[[WLAN Info API]]
+
|width=1%|
+
|width=40%|[[WLAN Management API]]
+
|---
+
|width=40%|[[Call Audio Control API]] <span style="color:red">***</span>
+
|width=1%|
+
|width=40%|[[VoIP Audio Service API]] <span style="color:red">***</span>
+
|---
+
 
|}
 
|}
  
<BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR>><BR><BR><BR><BR><BR><BR>
 
 
Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1
 
Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1
*Package URL: [http://www.forum.nokia.com/piazza/wiki/images/9/96/S60_3rd_ed_fp1_api_plug-in_pack_supplementary.zip S60 3rd Ed, FP1 API Plug-in Pack - Supplementary]
+
*Package URL: [[Media:S60 3rd ed fp1 api plug-in pack supplementary.zip|S60 3rd Ed, FP1 API Plug-in Pack - Supplementary]]
<BR>
+
  
 
Contents:
 
Contents:
 
+
{| class="wikitable"
:{|align=left
+
|[[Tuner Utility API]] <span style="color:green"> (new)</span>
|width=40%|[[Tuner Utility API]] <span style="color:green"> (new)</span>
+
|[[MMFDevSound API]] <span style="color:green"> (updated with WINSCW libraries)</span>
|width=1%|
+
|[[SIM Utils API]] ([[File:SIMUtilsAPI 3x 50.zip]])
|width=40%|[[MMFDevSound API]] <span style="color:green"> (updated with WINSCW libraries)</span>
+
|width=1%|
+
|width=40%|[[SIM Utils API]] ([[File:SIMUtilsAPI_3x_50.zip]])
+
 
|}
 
|}
  
<BR><BR><BR><BR><BR><BR>
 
=API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2=
 
  
*Package URL: [http://www.forum.nokia.com/info/sw.nokia.com/id/74011015-aec7-4ab0-aa5e-df04f02692d2/S60_3rd_Ed_SDK_FP2_API_Plug-In_Pack.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2]
+
 
 +
== S60 3rd Edition SDK, Feature Pack 2 (Symbian C++) ==
 +
 
 +
*Package URL: [http://www.developer.nokia.com/info/sw.nokia.com/id/74011015-aec7-4ab0-aa5e-df04f02692d2/S60_3rd_Ed_SDK_FP2_API_Plug-In_Pack.html Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2]
 
*Current version: 1.2
 
*Current version: 1.2
 
*Included APIs: 48
 
*Included APIs: 48
 
  
 
The following APIs are included:
 
The following APIs are included:
 +
{| class="wikitable"
 +
|[[Adaptive History List API for 3rd Edition Feature Pack 2]]
  
 +
|[[Archived:AIW Dial Data Consumer Symbian API]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Audio Metadata Reader API]]
 +
|[[Archived:Audio Routing API – Input and Output]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Alarm Clock One API]]
 +
|[[Archived:Bluetooth Engine API for S60 3rd Edition FP2]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Browser Launcher API]]
 +
|[[Archived:Calendar Exporter Symbian API]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Archived:Calendar Importer Symbian API]] <span style="color:green">(new)</span>
 +
|[[Archived:Calendar Settings Symbian API]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Call Audio Control API]] <span style="color:red">***</span>
 +
|[[Camera Application Engine API]]
 +
|-
 +
|[[Archived:Clock Settings Symbian API]] <span style="color:green">(new)</span>
 +
|[[CommsDat WLAN API]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Data Connection Log Counters API]]
 +
|[[Extended AIW Criteria API]]
 +
|-
 +
|[[Extended Skins API]]
 +
|[[Item Finder API]]
 +
|-
 +
|[[Archived:Setting various indicators on S60 3rd Edition FP2]]
 +
|[[Archived:Location Settings Launch Symbian API]] <span style="color:green">(new)</span>
 +
|-
 +
|[[Logs Timers API]]
  
:{|align=left
+
|[[Archived:Logs UI Command Line Symbian API]] <span style="color:green">(new)</span>
|width=40%|[[Adaptive History List API for 3rd Edition Feature Pack 2]]
+
|-
|width=1%|
+
|[[Archived:MDFDevVideo Record Symbian API]] <span style="color:green">(new)</span>
|width=40%|[[CS001026 - AIW Dial Data Consumer API]] <span style="color:green">(new)</span>
+
|[[MDFDevVideo Playback API]] <span style="color:green">(new)</span>
|---
+
|-
|width=40%|[[Audio Metadata Reader API]]
+
|[[Archived:Media File Symbian API]] <span style="color:green">(new)</span>
|width=1%|
+
|[[Media Player Utility API]] <span style="color:green">(new)</span>
|width=40%|[[Audio Routing API – Input and Output]] <span style="color:green">(new)</span>
+
|-
|---
+
|[[Media Recorder API]]
|width=40%|[[Alarm Clock One API]]
+
|[[Media Recorder Sink API]]
|width=1%|
+
|-
|width=40%|[[CS001064 - Bluetooth Engine API for S60 3rd Edition, Feature Pack 2]] <span style="color:green">(new)</span>
+
|[[MMFDevSound API]]
|---
+
|[[New File Service Client API]]
|width=40%|[[Browser Launcher API]]
+
|-
|width=1%|
+
|[[Archived:NSSTTS Common Symbian API]] <span style="color:green">(new)</span>
|width=40%|[[CS001028 - Calendar Exporter API]] <span style="color:green">(new)</span>
+
|[[Archived:NSSTTS Utility Symbian API]] <span style="color:green">(new)</span>
|---
+
|-
|width=40%|[[CS001027 - Calendar Importer API]] <span style="color:green">(new)</span>
+
|[[OMA Provisioning Adapter API]]
|width=1%|
+
|[[Archived:Personalisation and Skins Settings Symbian API]]
|width=40%|[[CS001038 - Calendar Settings API]] <span style="color:green">(new)</span>
+
|-
|---
+
|[[Archived:Phone Client USSD API]]<span style="color:green"> (new)</span>
|width=40%|[[Call Audio Control API]] <span style="color:red">***</span>
+
|[[Archived:Profiles Engine Active Profile Settings Symbian API]] <span style="color:green">(new)</span>
|width=1%|
+
|-
|width=40%|[[Camera Application Engine API]]
+
|[[Archived:Remote Control Extension Symbian API]] <span style="color:green">(new)</span>
|---
+
|[[S60 RTP/RTC API]]
|width=40%|[[CS001037 - Clock Settings API]] <span style="color:green">(new)</span>
+
|-
|width=1%|
+
|[[Archived:Screensaver Settings Symbian API]] <span style="color:green">(new)</span>
|width=40%|[[CommsDat WLAN API]] <span style="color:green">(new)</span>
+
|[[Settings Framework API]]
|---
+
|-
|width=40%|[[Data Connection Log Counters API]]
+
|[[Archived:Symbian Onboard Camera Advanced Settings API]] (CCameraAdvancedSettings) <span style="color:green">(new)</span>
|width=1%|
+
|[[SMS Utilities API]]
|width=40%|[[Extended AIW Criteria API]]
+
|-
|---
+
|[[Archived:Speech Encoder Config Symbian API]] <span style="color:green">(new)</span>
|width=40%|[[Extended Skins API]]
+
|[[SW Installer Launcher API]]
|width=1%|
+
|-
|width=40%|[[Item Finder API]]
+
|[[Send UI Technology Mail Uid Value API]]
|---
+
|[[VoIP Audio Service API]] <span style="color:red">***</span>
|width=40%|[[KCoreAppUIsNewEmailStatus API]]
+
|-
|width=1%|
+
|[[WLAN Info API]]
|width=40%|[[CS001035 - Location Settings Launch API]] <span style="color:green">(new)</span>
+
|[[WLAN Management API]]
|---
+
|-
|width=40%|[[Logs Timers API]]
+
|width=1%|
+
|width=40%|[[CS001032 - Logs UI Command Line API]] <span style="color:green">(new)</span>
+
|---
+
|width=40%|[[CS001065 - MDFDevVideo Record API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[MDFDevVideo Playback API]] <span style="color:green">(new)</span>
+
|---
+
|width=40%|[[CS001036 - Media File API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[Media Player Utility API]] <span style="color:green">(new)</span>
+
|---
+
|width=40%|[[Media Recorder API]]
+
|width=1%|
+
|width=40%|[[Media Recorder Sink API]]
+
|---
+
|width=40%|[[MMFDevSound API]]
+
|width=1%|
+
|width=40%|[[New File Service Client API]]
+
|---
+
|width=40%|[[CS001033 - NSSTTS Common API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[CS001031 - NSSTTS Utility API]] <span style="color:green">(new)</span>
+
|---
+
|width=40%|[[OMA Provisioning Adapter API]]
+
|width=1%|
+
|width=40%|[[CS001025 - Personalisation and Skins Settings API]]
+
|---
+
|width=40%|[[Phone Client USSD API]]<span style="color:green"> (new)</span>
+
|width=1%|
+
|width=40%|[[CS001024 - Profiles Engine Active Profile Settings API]] <span style="color:green">(new)</span>
+
|---
+
|width=40%|[[CS001034 - Remote Control Extension API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[S60 RTP/RTC API]]
+
|---
+
|width=40%|[[CS001039 - Screensaver Settings API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[Settings Framework API]]
+
|---
+
|width=40%|[[Symbian Onboard Camera Advanced Settings API]] (CCameraAdvancedSettings) <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[SMS Utilities API]]
+
|---
+
|width=40%|[[CS001030 - Speech Encoder Config API]] <span style="color:green">(new)</span>
+
|width=1%|
+
|width=40%|[[SW Installer Launcher API]]
+
|---
+
|width=40%|[[Send UI Technology Mail Uid Value API]]
+
|width=1%|
+
|width=40%|[[VoIP Audio Service API]] <span style="color:red">***</span>
+
|---
+
|width=40%|[[WLAN Info API]]
+
|width=1%|
+
|width=40%|[[WLAN Management API]]
+
|---
+
 
|}
 
|}
<BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR>
+
 
 
Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2
 
Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2
*Package URL: [http://www.forum.nokia.com/piazza/wiki/images/8/81/S60_3rd_ed_fp2_api_plug-in_pack_supplementary.zip S60 3rd Ed, FP2 API Plug-in Pack - Supplementary]
+
*Package URL: [[Media:S60 3rd ed fp2 api plug-in pack supplementary.zip|S60 3rd Ed, FP2 API Plug-in Pack - Supplementary]]
<BR>
+
  
 
Contents:
 
Contents:
 
+
{| class="wikitable"
:{|align=left
+
|[[Radio Utility API]]<span style="color:green"> (new)</span>
|width=40%|[[Radio Utility API]]<span style="color:green"> (new)</span>
+
|[[SIM Utils API]] ([[File:SIMUtilsAPI 3x 50.zip]])
|width=1%|
+
|width=40%|[[SIM Utils API]] ([[File:SIMUtilsAPI_3x_50.zip]])
+
 
|}
 
|}
<BR><BR><BR><BR><BR>
 
  
  
=API Plug-in for the S60 5th Edition SDK for Symbian OS, for C++=
 
  
*Package URL: [http://www.forum.nokia.com/info/sw.nokia.com/id/48a93bd5-028a-4b3e-a0b1-148ff203b2b3/Extensions_plugin_S60_3rd_ed.html Plug-ins for S60 3rd Edition and S60 5th Edition SDKs]
+
== S60 5th Edition SDK (Symbian C++) ==
  
<BR><BR>
+
*Package URL: [http://www.developer.nokia.com/info/sw.nokia.com/id/48a93bd5-028a-4b3e-a0b1-148ff203b2b3/Extensions_plugin_S60_3rd_ed.html Plug-ins for S60 3rd Edition and S60 5th Edition SDKs]
  
:{|align=left
+
{| class="wikitable"
|width=40%|[[Adaptive History List API for 5th Edition]]
+
|[[Adaptive History List API for 5th Edition]]
|width=1%|
+
 
|width=40%|[[AIW Dial Data Consumer API]]
+
|[[AIW Dial Data Consumer API]]
|---
+
|-
|width=40%|[[Alarm Const API]]
+
|[[Alarm Const API]]
|width=1%|
+
|[[Audio MetaData Reader API]]
|width=40%|[[Audio MetaData Reader API]]
+
|-
|---
+
|[[Audio Routing API]]
|width=40%|[[Audio Routing API]]
+
|[[Audio Visualization API]]
|width=1%|
+
|-
|width=40%|[[Audio Visualization API]]
+
|[[Browser Launcher API]]
|---
+
|[[Calendar Settings Keys API]]
|width=40%|[[Browser Launcher API]]
+
|-
|width=1%|
+
|[[Clock Settings API]]
|width=40%|[[Calendar Settings Keys API]]
+
|[[CommsDat WLAN API]]
|---
+
|-
|width=40%|[[Clock Settings API]]
+
|[[Data Connection Log Counters API]]
|width=1%|
+
|[[Extended AIW Criteria API]]
|width=40%|[[CommsDat WLAN API]]
+
|-
|---
+
|[[Extended Skins API]]
|width=40%|[[Data Connection Log Counters API]]
+
|[[Item Finder API]]
|width=1%|
+
|-
|width=40%|[[Extended AIW Criteria API]]
+
|[[Location Settings Launch API]]
|---
+
|[[Logs Timers API]]
|width=40%|[[Extended Skins API]]
+
|-
|width=1%|
+
|[[MDF DevVideoGeneral API]]
|width=40%|[[Item Finder API]]
+
|[[MDF DevVideoRecord API]]
|---
+
|-
|width=40%|[[Location Settings Launch API]]
+
|[[MDF VideoPlayback API]]
|width=1%|
+
|[[Media File API]]
|width=40%|[[Logs Timers API]]
+
|-
|---
+
|[[Media Player Utility API]]
|width=40%|[[MDF DevVideoGeneral API]]
+
|[[Media Recorder API]]
|width=1%|
+
|-
|width=40%|[[MDF DevVideoRecord API]]
+
|[[Media Recorder Sink API]]
|---
+
|[[MMFDevSound API]]
|width=40%|[[MDF VideoPlayback API]]
+
|-
|width=1%|
+
|[[New File Service Client API]]
|width=40%|[[Media File API]]
+
|[[NSS TTS Common API]]
|---
+
|-
|width=40%|[[Media Player Utility API]]
+
|[[NSS TTS Utility API]]
|width=1%|
+
|[[OMA Provisioning Adapter API]]
|width=40%|[[Media Recorder API]]
+
|-
|---
+
|[[Personalisation and Skins Settings API]]
|width=40%|[[Media Recorder Sink API]]
+
|[[Remote Control Extension API]]
|width=1%|
+
|-
|width=40%|[[MMFDevSound API]]
+
|[[RTP/RTCP API]]
|---
+
|[[Screensaver Settings API]]  
|width=40%|[[New File Service API]]
+
|-
|width=1%|
+
|[[Settings Framework API]]
|width=40%|[[NSS TTS Common API]]
+
|[[SMS Utilities API]]
|---
+
|-
|width=40%|[[NSS TTS Utility API]]
+
|[[Speech Encoder Config API]]
|width=1%|
+
|[[SRTP API]]
|width=40%|[[OMA Provisioning Adapter API]]
+
|-
|---
+
|[[SW Installer Launcher API]]
|width=40%|[[Personalisation and Skins Settings API]]
+
|[[SyncML Client API]]
|width=1%|
+
|-
|width=40%|[[Remote Control Extension API]]
+
|[[System Application Notification API]]
|---
+
|[[TVOut Engine API]]
|width=40%|[[RTP/RTCP API]]
+
|-
|width=1%|
+
|[[VoIP Audio Service API]]
|width=40%|[[Screensaver Settings API]]  
+
|[[WLAN Info API]]
|---
+
|-
|width=40%|[[Settings Framework API]]
+
|[[WLAN Management API]]
|width=1%|
+
|
|width=40%|[[SMS Utilities API]]
+
|-
|---
+
|width=40%|[[Speech Encoder Config API]]
+
|width=1%|
+
|width=40%|[[SRTP API]]
+
|---
+
|width=40%|[[SW Installer Launcher API]]
+
|width=1%|
+
|width=40%|[[SyncML Client API]]
+
|---
+
|width=40%|[[System Application Notification API]]
+
|width=1%|
+
|width=40%|[[TVOut Engine API]]
+
|---
+
|width=40%|[[VoIP Audio Service API]]
+
|width=1%|
+
|width=40%|[[WLAN Info API]]
+
|---
+
|width=40%|[[WLAN Management API]]
+
|width=1%|
+
|width=40%|
+
|---
+
 
|}
 
|}
<BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR>><BR><BR><BR><BR><BR><BR>
 
  
 
Supplementary packages for API Plug-in for the S60 5th Edition SDK for Symbian OS, for C++
 
Supplementary packages for API Plug-in for the S60 5th Edition SDK for Symbian OS, for C++
*Package URL: [http://www.forum.nokia.com/piazza/wiki/images/d/d1/S60_5th_ed_api_plug-in_pack_supplementary.zip S60 5th Edition API Plug-in Pack - Supplementary]
+
*Package URL: [[Media:S60 5th ed api plug-in pack supplementary.zip|S60 5th Edition API Plug-in Pack - Supplementary]]
<BR>
+
  
 
Contents:
 
Contents:
 
+
{| class="wikitable"
:{|align=left
+
|[[Radio Utility API]]<span style="color:green"> (new)</span>
|width=40%|[[Radio Utility API]]<span style="color:green"> (new)</span>
+
|[[MMFDevSound API]] <span style="color:green"> (ARMV5 + WINSCW libraries)</span>
|width=1%|
+
|[[SIM Utils API]] ([[File:SIMUtilsAPI 3x 50.zip]])
|width=40%|[[MMFDevSound API]] <span style="color:green"> (ARMV5 + WINSCW libraries)</span>
+
|width=1%|
+
|width=40%|[[SIM Utils API]] ([[File:SIMUtilsAPI_3x_50.zip]])
+
 
|}
 
|}
<BR><BR><BR><BR>
 
  
 
----
 
----
 
<span style="color:red">***</span> - Contains a SIS file compatible only with Nokia devices.
 
<span style="color:red">***</span> - Contains a SIS file compatible only with Nokia devices.
 +
 +
== Symbian^3 and later (Symbian C++) ==
 +
 +
No SDK API plugins are available or planned for the Symbian^3 SDK (or later).
 +
 +
We highly recommend that developers restrict themselves to Qt, Qt Mobility or public Symbian C++ APIs. With the current rapid release cycle for Symbian^3 the risk that unsupported APIs will break between releases is high.
 +
 +
If functionality from SDK API plugins is required on Symbian^3 developers can request access through a technical support case or can roll out their own solutions using the PDK (available from http://symbian.nokia.com/). In either case, there remain no guarantees of compatibility through device updates and developers will need to rigorously retest APIs between releases.
  
  
= FAQ =
+
== FAQ ==
  
 
<HR>
 
<HR>
Line 500: Line 409:
 
<HR>
 
<HR>
 
*'''Question:''' One of the existing APIs solves partly my problem but for a full solution I need access to another internal API. Can you provide that API in the same plug-in?
 
*'''Question:''' One of the existing APIs solves partly my problem but for a full solution I need access to another internal API. Can you provide that API in the same plug-in?
*'''Answer:''' Each API has been released with a specific use case in mind. If you need some other API to accomplish your task, it is likely that you are outside the intended use case and the only solution for you is the [[S60 API Partnering Program|S60 API Partnering]] process. Please note that if the dependency is on a Symbian owned API, you will have to contact Symbian Ltd. for requesting the API.
+
*'''Answer:''' Each API has been released with a specific use case in mind. If you need some other API to accomplish your task, it is likely that you are outside the intended use case and the only solution for you is the [[Accessing internal platform APIs through the API Partnering Program]] process. Please note that if the dependency is on a Symbian owned API, you will have to contact Symbian Ltd. for requesting the API.
 
<HR>
 
<HR>
 
*'''Question:''' The API I need requires manufacturer granted capabilities. Are these capabilities going to be granted to me?
 
*'''Question:''' The API I need requires manufacturer granted capabilities. Are these capabilities going to be granted to me?
Line 513: Line 422:
 
*'''Question:''' Will these APIs work in ALL S60 devices, regardles of the manufacturer?
 
*'''Question:''' Will these APIs work in ALL S60 devices, regardles of the manufacturer?
 
*'''Answer:''' These API have been tested on a limited set of Nokia devices and there is no binary compatibility promise given even for them. They might work on other devices too but developers are expected to perform thorough testing befor distributing applications using these API. Please note also the APIs marked with <span style="color:red">***</span>, they can only be used after installing binaries on the phone and those binaries are currently only available for Nokia devices.
 
*'''Answer:''' These API have been tested on a limited set of Nokia devices and there is no binary compatibility promise given even for them. They might work on other devices too but developers are expected to perform thorough testing befor distributing applications using these API. Please note also the APIs marked with <span style="color:red">***</span>, they can only be used after installing binaries on the phone and those binaries are currently only available for Nokia devices.
<BR><BR>
 
  
[[Category:SDK]]
+
[[Category:Code Examples]]
 +
<!-- Translation --> [[zh-hans:SDK中的API外掛程式]]

Revision as of 03:29, 14 September 2012

As a response to the frequent requests expressed by the 3rd party developers for more internal APIs to be released, Nokia Developer is providing the Accessing internal platform APIs through the API Partnering Program process through which any developer can apply for access to the APIs needed to implement a given functionality. Whether the request is approved or not it all depends on the business justification provided and the current status of the APIs ( binary compatibility breaks, API deprecation, security considerations ... )

The receiver of the API should understand that despite the initial testing, which is intended to show that the API works on the targeted device, no guarantees can be given with regards to the binary compatibility or the availability of the API across platform version or even within devices released based on the current platform version.

As the number of processed API Partnering requests grew, the decision was made that some of the partnered APIs are released to the whole developer community. However, due to the above mentioned binary compatibility issues the release was made without any marketing campaign and the API Packages were released in archived mode.

The following very important message accompanies the plug-in and is also included in each API's release notes, please read carefully:

Warning.pngWarning: PLEASE NOTICE THE FOLLOWING ISSUES WITH THESE APIs:

  1. Nokia is not giving any binary compatibility promise for these APIs; neither between platform versions or within a platform version.
  2. You must test your application with each device that the application can be installed on. This is needed to ensure the best possible user experience. To prevent application installation on other than tested devices, define the Product ID(s) (also known as Machine UID) in the .pkg file. More information can be found in the document S60 Platform: Identification Codes available on the Nokia Developer website.

The API plug-in package is also covered by a click through Limited License Agreement (LLA), the content of which is also included in the package. The use of the API included in the API Plug-in assumes that the LLA is implicitly accepted.

Note.pngNote: The content of the Limited License Agreement (LLA) has been updated to address the concerns regarding the usage of the API in 3rd Party projects.

Note.pngNote: The latest version of the VoIP Audio Services API device binaries (SIS file) can now be found through API's page in this wiki.

Currently the following API Plug-in packages are available:

Contents

S60 3rd Edition SDK, MR (Symbian C++)

The following APIs are included:

Adaptive History List API AIW Criteria API
AIW Generic Parameters API AIW Service Handler API
Audio Metadata Reader API Audio Proxy Server API v2.43 ***
Bluetooth Engine API Browser Launcher API
Camera Application Engine API CR Keys To Control Phone Volume API
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
KAccessoryModeChanged API KAlarmClockOne API
Archived:Setting various indicators on S60 3rd Edition FP2 Logs Client API
Logs Timers API Media Player Engine API
Media Recorder API Meeting Request API
WLAN Management API New File Service Client API
OMA Provisioning Adapter API Personalisation Skins Settings API
Phone Client Dial API Phone Client Extension API
Profiles Engine API Profiles Engine Extended API
Profile UID API PS Keys for Call Status & Indicators API
S60 RTP/RTC API ScShortcuts Engine Wrapper API
Shared Data API SMS Utilities API
SW Installer Launcher API SyncML Client API
WLAN Info API WLAN Settings UI API
PS Keys for WLAN API


S60 3rd Edition SDK, Feature Pack 1 (Symbian C++)

The following APIs are included:

Adaptive History List API for 3rd Edition Feature Pack 1 AIW Criteria API
AIW Generic Parameters API AIW Service Handler API
Audio Metadata Reader API Audio Proxy Server API v2.43 (deprecated),***
Audio Routing API Bluetooth Engine API
Browser Launcher API CR Keys To Control Phone Volume API
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
KAccessoryModeChanged API KAlarmClockOne API
Archived:Setting various indicators on S60 3rd Edition FP2 Logs Client API
Logs Timers API Media Player Engine API
Media Recorder API Meeting Request API
MMFDevSound API Music Player Remote Control API
New File Service Client API OMA Provisioning Adapter API
Personalisation Skins Settings API Phone Client Dial API
Phone Client Extension API Profiles Engine Extended API
Profile UID API PS Keys for Call Status & Indicators API
S60 RTP/RTC API ScShortcuts Engine Wrapper API
Settings Framework API SMS Utilities API
SW Installer Launcher API SyncML Client API
WLAN Info API WLAN Management API
Call Audio Control API *** VoIP Audio Service API ***

Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1

Contents:

Tuner Utility API (new) MMFDevSound API (updated with WINSCW libraries) SIM Utils API (File:SIMUtilsAPI 3x 50.zip)


S60 3rd Edition SDK, Feature Pack 2 (Symbian C++)

The following APIs are included:

Adaptive History List API for 3rd Edition Feature Pack 2 Archived:AIW Dial Data Consumer Symbian API (new)
Audio Metadata Reader API Archived:Audio Routing API – Input and Output (new)
Alarm Clock One API Archived:Bluetooth Engine API for S60 3rd Edition FP2 (new)
Browser Launcher API Archived:Calendar Exporter Symbian API (new)
Archived:Calendar Importer Symbian API (new) Archived:Calendar Settings Symbian API (new)
Call Audio Control API *** Camera Application Engine API
Archived:Clock Settings Symbian API (new) CommsDat WLAN API (new)
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
Archived:Setting various indicators on S60 3rd Edition FP2 Archived:Location Settings Launch Symbian API (new)
Logs Timers API Archived:Logs UI Command Line Symbian API (new)
Archived:MDFDevVideo Record Symbian API (new) MDFDevVideo Playback API (new)
Archived:Media File Symbian API (new) Media Player Utility API (new)
Media Recorder API Media Recorder Sink API
MMFDevSound API New File Service Client API
Archived:NSSTTS Common Symbian API (new) Archived:NSSTTS Utility Symbian API (new)
OMA Provisioning Adapter API Archived:Personalisation and Skins Settings Symbian API
Archived:Phone Client USSD API (new) Archived:Profiles Engine Active Profile Settings Symbian API (new)
Archived:Remote Control Extension Symbian API (new) S60 RTP/RTC API
Archived:Screensaver Settings Symbian API (new) Settings Framework API
Archived:Symbian Onboard Camera Advanced Settings API (CCameraAdvancedSettings) (new) SMS Utilities API
Archived:Speech Encoder Config Symbian API (new) SW Installer Launcher API
Send UI Technology Mail Uid Value API VoIP Audio Service API ***
WLAN Info API WLAN Management API

Supplementary packages for API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2

Contents:

Radio Utility API (new) SIM Utils API (File:SIMUtilsAPI 3x 50.zip)


S60 5th Edition SDK (Symbian C++)

Adaptive History List API for 5th Edition AIW Dial Data Consumer API
Alarm Const API Audio MetaData Reader API
Audio Routing API Audio Visualization API
Browser Launcher API Calendar Settings Keys API
Clock Settings API CommsDat WLAN API
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
Location Settings Launch API Logs Timers API
MDF DevVideoGeneral API MDF DevVideoRecord API
MDF VideoPlayback API Media File API
Media Player Utility API Media Recorder API
Media Recorder Sink API MMFDevSound API
New File Service Client API NSS TTS Common API
NSS TTS Utility API OMA Provisioning Adapter API
Personalisation and Skins Settings API Remote Control Extension API
RTP/RTCP API Screensaver Settings API
Settings Framework API SMS Utilities API
Speech Encoder Config API SRTP API
SW Installer Launcher API SyncML Client API
System Application Notification API TVOut Engine API
VoIP Audio Service API WLAN Info API
WLAN Management API

Supplementary packages for API Plug-in for the S60 5th Edition SDK for Symbian OS, for C++

Contents:

Radio Utility API (new) MMFDevSound API (ARMV5 + WINSCW libraries) SIM Utils API (File:SIMUtilsAPI 3x 50.zip)

*** - Contains a SIS file compatible only with Nokia devices.

Symbian^3 and later (Symbian C++)

No SDK API plugins are available or planned for the Symbian^3 SDK (or later).

We highly recommend that developers restrict themselves to Qt, Qt Mobility or public Symbian C++ APIs. With the current rapid release cycle for Symbian^3 the risk that unsupported APIs will break between releases is high.

If functionality from SDK API plugins is required on Symbian^3 developers can request access through a technical support case or can roll out their own solutions using the PDK (available from http://symbian.nokia.com/). In either case, there remain no guarantees of compatibility through device updates and developers will need to rigorously retest APIs between releases.


FAQ


  • Question: The API I am using is not working on some devices. Should I report this as a bug against the platform?
  • Answer: It is likely that this is due to a scheduled change in API's implementation, however, if you see the bug as also affecting the firmware components then the best approach would be to report it.

  • Question: Will there be an announcement that a BC break was introduced in one of the S60 Platform builds if it affects one of the APIs from the plug-in?
  • Answer: This kind of notification will be provided on best effort bases.

  • Question: The APIs included in the plug-in are poorly documented. Where can I find better documentation?
  • Answer: As the APIs were not intended for publishing there is no SDK level documentation available for them. These wiki pages are intended to compensate this documentation gap.

  • Question: Are there any example applications available for these APIs?
  • Answer: The only API that includes an example application is the Audio Proxy Server. More examples will be added to this wiki page as they will become available. You are of course welcome to contribute.

  • Question: One of the existing APIs solves partly my problem but for a full solution I need access to another internal API. Can you provide that API in the same plug-in?
  • Answer: Each API has been released with a specific use case in mind. If you need some other API to accomplish your task, it is likely that you are outside the intended use case and the only solution for you is the Accessing internal platform APIs through the API Partnering Program process. Please note that if the dependency is on a Symbian owned API, you will have to contact Symbian Ltd. for requesting the API.

  • Question: The API I need requires manufacturer granted capabilities. Are these capabilities going to be granted to me?
  • Answer: The standard process for requesting manufacturer approved capabilities applies for these APIs too.

  • Question: Are you publishing all the frequently requested APIs in these plug-ins?
  • Answer: Only the APIs which are considered stable enough and of wide interest are released in this plug-in. A special case is the API needed for creating Active Idle plug-ins as though it otherwise meets the criteria for being released in this plug-in it also requires for the developed 3rd party plug-in to be enabled in the firmware (i.e. firmware variant creation) and this makes the API unusable for most developers.

  • Question: Where can I find the WINSCW/GCCE libraries for these APIs?
  • Answer: The libraries included in this package are built at a later date that the public SDK. To speed up the release date and to avoid SDK incompatibilities it was decided that the WINSCW libraries will not be published. For the GCCE platform the ARMV5 libraries are used seamlessly.

  • Question: Will these APIs work in ALL S60 devices, regardles of the manufacturer?
  • Answer: These API have been tested on a limited set of Nokia devices and there is no binary compatibility promise given even for them. They might work on other devices too but developers are expected to perform thorough testing befor distributing applications using these API. Please note also the APIs marked with ***, they can only be used after installing binaries on the phone and those binaries are currently only available for Nokia devices.
703 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×