[Bada开发]API官方学习1

本文翻译自三星bada的官方文档，通过本文你可以了解bada API的结构和使用方法，以及Privileged API的使用方法。Bada的开放API可以被分为三个层次：非优先的，普通的和系统，对此开发人员有不同的优先级。

bada API参考概览

bada API参考说明了所有bada命名空间，类和方法。Osp是根命名空间，包含bada内的所有其它命名空间。

下面的信息与各个命名空间相关：

次命名空间（如果有）；

变量与枚举；

详细说明；

要求的头文件和库；

命名空间概述；

说明

下面的部分说明如何使用bada API参考：

1. 方法说明结构；

2. 使用API；

3. 使用Privileged API；

4. 使用登陆

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，而无需任何特别权限。因此，你不需要在bada开发人员网站上赋值privilege group，以能够使用属于这个等级的API。
普通	基本	这个等级包括作为bada成员的开发人员才能够使用的API，如果它们在bada开发人员网站上赋值特定的privilege group。
系统	合作伙伴	这个等级包括与三星与特定合作关系的开发人员使用的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的代码范例：

1. void
2. MyAppClass::AppControlSignInSample(void)
3. {
4.    ArrayList* pDataList = null;
5.    AppControl* pAc = AppManager::FindAppControlN(APPCONTROL_SIGNIN,
6.  OPERATION_SIGNIN);
7.    if(pAc)
8.    {
9.        pAc->Start(null, this);
10.        delete pAc;
11.    }
12. }