SDK中的API外掛程式

Please wait 七月 17th, 2009 by ㄚ琪 | |2009/07/17

這一篇是我在SDK API Plug-in的中文翻譯，網址在SDK中的API外掛程式！
為了備份，並轉貼在此：

為了應付第三方開發所表示的一直要求更多內部API的釋出，諾基亞論壇正提供S60 API的合作程序，任何的開發人員可以透過這些程序來存取執行一個給定功能的API需要，請求是否得到批准取決於所提供的商業理由及API的目前狀況(二進制相容的打破、不再建議使用的API、安全的考量等等)

API的接受者應該明瞭儘管最初的測試用來表明該API可以在目標設備運作，不能保證可以得到關於跨平台版本的API的二進制相容或可用性，或即使是基於目前平台版本的設備發行也一樣。
隨著API合作程序請求的增長，作出了上述決定，有一些合作的API被釋放到整個開發者社區，然而，由於上述二進制相容性問題在沒有任何市場推廣活動下產生而且API套件以歸檔模式方式釋出。

下面很重要的訊息伴隨著外掛程式，也包刮在每一個API的發行說明裡，請仔細閱讀：

請注意下面這些API的議題：

諾基亞不會給予任何二進制相容的承諾；既不在平台版本間也不在一個平台版本內。
你必須測試您的應用程式安裝在每一台設備上，這是必要的以確保最有可能的使用者經驗，要避免應用程式安裝在其他的測試裝備上，需要在.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

套件位址：Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, MR
目前版本：5.43
包括的API：41

下面包括在內的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

套件位址:Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1
目前版本:2.5
涵括的API:42

下面涵括的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

套件位址：Extensions plug-in package for S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2
目前版本：1.2
涵括的API：48

下面所涵括的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++

套件位址：Extensions Plug-ins for S60 3rd Edition and S60 5th Edition SDKs

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，只可以在手機上安裝二進制檔後使用，而且那些二進制檔案目前只可以在諾基亞的機器上使用。

歷史上的今天

Be Sociable, Share!

作者：ㄚ琪 | 本文分類：[C_and_CPP],[翻譯] | 留言 | 引用

透過Facebook發表迴響，不保證ㄚ琪可以知道你的留言：

One Response to “SDK中的API外掛程式”

Symbian Applications 說道：

2009-08-10 at 04:07:36

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.

回覆