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学习笔记：基本概念