bada API參考概覽

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

下面的信息與各個命名空間相關：

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

1．方法說明結構

在各個類的成員功能文件中，說明了使用統一的結構的方法，如下所示：

2．使用API

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

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

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

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

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

c. 檢查所需庫

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

d. 在你的項目庫列表中添加所要求的庫。

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

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

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

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

d) 為了添加庫，點擊Add圖標，填寫庫名稱，點擊OK。

e) 為了添加庫搜索路徑，點擊Add圖標，填寫庫搜索路徑，點擊OK

f) 點擊Apply，保存更改到項目屬性。

3．使用Privileged API

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

Bada的開放API可以被分為三個層次：非優先的，普通的和系統。下面的表格包括了相關的信息，及相應的開發人員成員等級。

表：API 優先等級

 每個API的優先等級都在API參考中有所說明。

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

為了使用Osp::Commerce::Store::ItemService::ItemService( void ), 你需要持有在bada開發人員網站上的合作伙伴成員等級，因為constructor的優先等級是系統。

而且，你必須選擇bada開發人員網站上的My Applications > Application Manager里的COMMERCE STORE。

從開發人員網站上下載manifest.xml 文件，放入你的項目的根目錄中，覆蓋現有的manifest file。

注意：如果你開始開發程序了，但是沒有包含開發人員網站上定義的設置的manifest.xml文件，你需要在manifest file（從開發人員網站上下載）上創建一個應用程序項目。

4. 使用登陸

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

如果某個方法要求登錄，這就顯示在先決條件下的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的基本風格
2. bada開發簡介：控件的使用
3. 三星bada學習筆記：HelloWorld篇
4. 三星bada開發平臺概述
5. 三星bada學習筆記：基本概念