bada API參考概覽

bada API參考說明了所有bada命名空間，類和方法。Osp是根命名空間，包含bada內(nèi)的所有其它命名空間。

下面的信息與各個命名空間相關(guān)：

下面的部分說明如何使用bada API參考：

1．方法說明結(jié)構(gòu)

在各個類的成員功能文件中，說明了使用統(tǒng)一的結(jié)構(gòu)的方法，如下所示：

2．使用API

為了能夠使用API，你需要采取以下步驟：

a. 檢查所要求的頭文件。

為了能在你的項(xiàng)目中使用特定的API，你需要包含它的頭文件。所要求的文件列出在bada API Reference中的備注下。例如，如果你的程序使用Osp::App::AppControl類，你必須包括FApp.h，如Osp::App頁面上的備注下所示。

b. 在你的源代碼中添加所要求的頭文件

例如，為了使用Osp::App::AppControl類，你必須在源代碼中包含F(xiàn)App.h 文件，如下所示：

c. 檢查所需庫

為了能在你的項(xiàng)目中使用特定的API，你還需要包含所要求的庫文件。要求的庫列出在bada API參考中的備注下。例如，如果你的程序使用Osp::App::AppControl類，你必須添加FApp庫，如Osp::App頁面上的備注下內(nèi)容所示。

d. 在你的項(xiàng)目庫列表中添加所要求的庫。

為了添加庫搜索路徑和庫：

a) 在bada IDE Project Explorer中，右擊項(xiàng)目，選擇屬性；

b) 選擇 C/C++ Build > Settings；

c) 在Tool Settings tab中，選擇配置，添加庫和庫搜索路徑。

d) 為了添加庫，點(diǎn)擊Add圖標(biāo)，填寫庫名稱，點(diǎn)擊OK。

e) 為了添加庫搜索路徑，點(diǎn)擊Add圖標(biāo)，填寫庫搜索路徑，點(diǎn)擊OK

f) 點(diǎn)擊Apply，保存更改到項(xiàng)目屬性。

3．使用Privileged API

bada API的開放程度不同。有些API被稱之為privileged API，處理平臺和用戶敏感數(shù)據(jù)。為了能使用privileged API，程序必須在bada開發(fā)人員網(wǎng)站上賦值相應(yīng)的privilege groups。并且，privilege API的使用必須在manifest file中恰當(dāng)說明。

Bada的開放API可以被分為三個層次：非優(yōu)先的，普通的和系統(tǒng)。下面的表格包括了相關(guān)的信息，及相應(yīng)的開發(fā)人員成員等級。

表：API 優(yōu)先等級

 每個API的優(yōu)先等級都在API參考中有所說明。

例如， Osp::Commerce::Store::ItemService::ItemService( void ) constructor 具有系統(tǒng)優(yōu)先等級，要求你的程序賦值COMMERCE_STORE privilege group，如下所示：

為了使用Osp::Commerce::Store::ItemService::ItemService( void ), 你需要持有在bada開發(fā)人員網(wǎng)站上的合作伙伴成員等級，因?yàn)閏onstructor的優(yōu)先等級是系統(tǒng)。

而且，你必須選擇bada開發(fā)人員網(wǎng)站上的My Applications > Application Manager里的COMMERCE STORE。

從開發(fā)人員網(wǎng)站上下載manifest.xml 文件，放入你的項(xiàng)目的根目錄中，覆蓋現(xiàn)有的manifest file。

注意：如果你開始開發(fā)程序了，但是沒有包含開發(fā)人員網(wǎng)站上定義的設(shè)置的manifest.xml文件，你需要在manifest file（從開發(fā)人員網(wǎng)站上下載）上創(chuàng)建一個應(yīng)用程序項(xiàng)目。

4. 使用登陸

程序可以使用sign-in AppControl登錄到bada服務(wù)器。登陸的過程包括使用認(rèn)證，這樣程序用戶必須在bada服務(wù)器上有一個用戶配置文件，使用密碼認(rèn)證。登錄AppControl支持單次的登錄，這就意味著用戶只需要登錄一次，并且可以使用其它程序登陸bada服務(wù)器，而不需再次登錄。認(rèn)證保持有效，直到電話被關(guān)系。

如果某個方法要求登錄，這就顯示在先決條件下的API參考中，如下所示。

Precondition:

User should be authenticated.

For more information, see the sign in Application control (Osp::App::APPCONTROL_SIGNIN).

下面是一個使用sign-in AppControl的代碼范例：

void 
MyAppClass::AppControlSignInSample(void)  
{  
   ArrayList* pDataList = null;  
   AppControl* pAc = AppManager::FindAppControlN(APPCONTROL_SIGNIN,  
 OPERATION_SIGNIN);  
   if(pAc)  
   {  
       pAc->Start(null, this);  
       delete pAc;  
   }  
} 

【編輯推薦】

1. 三星bada：Open API的基本風(fēng)格
2. bada開發(fā)簡介：控件的使用
3. 三星bada學(xué)習(xí)筆記：HelloWorld篇
4. 三星bada開發(fā)平臺概述
5. 三星bada學(xué)習(xí)筆記：基本概念