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的代码范例:
- void
- MyAppClass::AppControlSignInSample(void)
- {
- ArrayList* pDataList = null;
- AppControl* pAc = AppManager::FindAppControlN(APPCONTROL_SIGNIN,
- OPERATION_SIGNIN);
- if(pAc)
- {
- pAc->Start(null, this);
- delete pAc;
- }
- }
【编辑推荐】