SDK中的API外挂程式

这一篇是我在SDK API Plug-in的中文翻译,网址在SDK中的API外挂程式
为了备份,并转贴在此:

为了应付第三方开发所表示的一直要求更多内部API的释出,诺基亚论坛正提供S60 API的合作程序,任何的开发人员可以透过这些程序来存取执行一个给定功能的API需要, 请求是否得到批准取决于所提供的商业理由及API的目前状况(二进制相容的打破、不再建议使用的API、安全的考量等等)

API的接受者应该明了尽管最初的测试用来表明该API可以在目标设备运作,不能保证可以得到关于跨平台版本的API的二进制相容或可用性,或即使是基于目前平台版本的设备发行也一样。
随着API合作程序请求的增长,作出了上述决定,有一些合作的API被释放到整个开发者社区,然而,由于上述二进制相容性问题在没有任何市场推广活动下产生而且API套件以归档模式方式释出。

下面很重要的讯息伴随着外挂程式,也包刮在每一个API的发行说明里,请仔细阅读:


请注意下面这些API的议题:

  1. 诺基亚不会给予任何二进制相容的承诺;既不在平台版本间也不在一个平台版本内。
  2. 你必须测试您的应用程式安装在每一台设备上,这是必要的以确保最有可能的使用者经验,要避免应用程式安装在其他的测试装备上,需要在.pkg档定义Product ID(产品ID)(也称作Machine UID机器UID),更多的讯息可以在诺基亚论坛网站的文件S60 Platform: Identification Codes里找到。

API外挂程式套件还涵盖了通过点击的Limited License Agreement (LLA)协定,其内容也包括在套件里,含括在API外挂程式中的API使用也假定毫无保留地接受LLA协定。

Note!
Limited License Agreement (LLA)内容已经更新可以解决第三方专案里的API使用的关切议题。

外挂程式

目前可用的API外挂程式套件列于下:

API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, MR

下面包括在内的API:

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
KCoreAppUIsNewEmailStatus API 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

>

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

下面涵括的API:

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 (不建议使用),***
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
KCoreAppUIsNewEmailStatus API 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 ***

>

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

下面所涵括的API:

Adaptive History List API for 3rd Edition Feature Pack 2 CS001026 – AIW Dial Data Consumer API (新的)
Audio Metadata Reader API Audio Routing API – Input and Output (新的)
Alarm Clock One API CS001064 – Bluetooth Engine API S60 3rd Edition, FP2 (新的)
Browser Launcher API CS001028 – Calendar Exporter API (新的)
CS001027 – Calendar Importer API (新的) CS001038 – Calendar Settings API (新的)
Call Audio Control API *** Camera Application Engine API
CS001037 – Clock Settings API (新的) CommsDat WLAN API (新的)
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
KCoreAppUIsNewEmailStatus API CS001035 – Location Settings Launch API (新的)
Logs Timers API CS001032 – Logs UI Command Line API (新的)
CS001065 – MDFDevVideo Record API (新的) MDFDevVideo Playback API (新的)
CS001036 – Media File API (新的) Media Player Utility API (新的)
Media Recorder API Media Recorder Sink API
MMFDevSound API New File Service Client API
CS001033 – NSSTTS Common API (新的) CS001031 – NSSTTS Utility API (新的)
OMA Provisioning Adapter API CS001025 – Personalisation and Skins Settings API
Phone Client USSD API (新的) CS001024 – Profiles Engine Active Profile Settings API (新的)
CS001034 – Remote Control Extension API (新的) S60 RTP/RTC API
CS001039 – Screensaver Settings API (新的) Settings Framework API
Symbian Onboard Camera Advanced Settings API (CCameraAdvancedSettings) (新的) SMS Utilities API
CS001030 – Speech Encoder Config API (新的) SW Installer Launcher API
Send UI Technology Mail Uid Value API VoIP Audio Service API ***
WLAN Info API WLAN Management API

API Plug-in for the S60 5th Edition SDK for Symbian OS, for 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 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

*** – 包含的SIS档只跟诺基亚的设备相容。

常见问题解答


  • 问题: 我现在使用的API在一些机器上不能使用,我应该报告这为错误到平台上吗?
  • 回答: 很可能是由于API的执行有一个计划的变更,然而,假如你看到这个错误也有影响到韧体元件的话就应该报告。

  • 问题: 那会有一个宣布说一个S60平台的建立介绍了BC break,假如这平台影响外挂程式的一个API吗?
  • 回答: 这样的通知会尽可能地提供。

  • 问题: 外挂程式中的API很少有文件,我可以在哪找到较好的文件?
  • 回答: 由于API不倾向于出版,所以没有SDK程度的文件可以用,这些维基网页倾向于补足这个文件的缺口。

  • 问题: 这些API有范例应用程式可以用吗?
  • 回答: 只有Audio Proxy ServerAPI有涵括一个范例应用程式,更多的范例会加在这个维基网页一样可以使用,当然也欢迎你来贡献。

  • 问题: 现有的一个API解决了我的部份问题,但是要完全解决我需要存取另一个内部API,你可以提供相同外挂程式的API吗?
  • 回答: 记住每一个API释出都有一个特殊的使用情形,假如你需要一些其他的API来完成你的工作,很可能你超出了其使用的范畴,你的唯一解决途径是S60 API 合作程序,请注意如果是仰赖于Symbian自有的API,你需要联络Symbian有限公司请求API。

  • 问题: 我需要的API需要厂商的授予能力,这些能力可以授予给我吗?
  • 回答: 标准的请求厂商核定能力的程序也适用于这些API。

  • 问题: 你们正在出版所有常见的API在这些外挂程式中吗?
  • 回答: 只有那些被考量为够稳定及兴趣够广的API才会出版在外挂程式中,一个特殊状况是这个API需要建立有效的闲置外挂程式就好像它符合标准可以出版在外挂程 式里,这个外挂程式也需要第三方外挂程式的开发在韧体中启用(例如韧体不同版本的建立)以及这对大多数的开发人员来说会让这个API无法使用。

  • 问题: 我在哪里可以找到这些API的WINSCW/GCCE函式库?
  • 回答: 涵括在套件中的函式库会稍后建立,为了加快发行日期并避免SDK不相容,已经决定不出版WINSCW函式库,对于GCCE平台来说ARMV5函式库可以使用。

  • 问题: 这些API全都可以在S60的机器上使用而不管制造厂商吗?
  • 回答: 这些API在一些诺基亚的机器上测试,并且没有给出二进制相的承诺,他们可能在其他的机器上也可以用但希望开发人员在使用这些API分发应用程式前可以透过测试来执行,也请注意那些标示***标记的API,只可以在手机上安装二进制档后使用,而且那些二进制档案目前只可以在诺基亚的机器上使用。

1 則留言

  1. I like my legendary N96. I found your blog on google and read a few of your other posts. I just added you to my Google News Reader. Look forward to reading more from you in the future.

Comments are closed.