官方文档:bada API参考资料

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

bada API参考概览

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

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

次命名空间(如果有);

变量与枚举;

详细说明;

要求的头文件和库;

命名空间概述;

说明

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

1. 方法说明结构;

2. 使用API;

3. 使用Privileged API;

4. 使用登陆

1.方法说明结构

在各个类的成员功能文件中,说明了使用统一的结构的方法,如下所示:

bada

2.使用API

为了能够使用API,你需要采取以下步骤:

a. 检查所要求的头文件。

为了能在你的项目中使用特定的API,你需要包含它的头文件。所要求的文件列出在bada API Reference中的备注下。例如,如果你的程序使用Osp::App::AppControl类,你必须包括FApp.h,如Osp::App页面上的备注下所示。

bada

b. 在你的源代码中添加所要求的头文件

例如,为了使用Osp::App::AppControl类,你必须在源代码中包含FApp.h 文件,如下所示:

bada

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中,选择配置,添加库和库搜索路径。

bada

d) 为了添加库,点击Add图标,填写库名称,点击OK。

bada

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,如下所示:

bada

为了使用Osp::Commerce::Store::ItemService::ItemService( void ), 你需要持有在bada开发人员网站上的合作伙伴成员等级,因为constructor的优先等级是系统。

而且,你必须选择bada开发人员网站上的My Applications > Application Manager里的COMMERCE STORE。

bada

从开发人员网站上下载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.    }  

【编辑推荐】

  1. 三星bada:Open API的基本风格
  2. bada开发简介:控件的使用
  3. 三星bada学习笔记:HelloWorld篇
  4. 三星bada开发平台概述
  5. 三星bada学习笔记:基本概念
责任编辑:佚名 来源: 三星官网
相关推荐

2010-04-21 14:25:22

bada三星

2010-06-24 14:38:48

Linux Cat命令

2009-08-25 09:33:59

思科认证CCIE R&参考资料

2011-03-17 08:58:09

数据储存Data StoragAndroid API

2013-04-12 03:40:53

微信开放平台朋友圈

2010-02-07 14:00:46

badaC++

2013-09-02 16:13:56

API应用资源

2011-12-29 10:22:24

三星BadaBada 2.0

2009-02-23 20:20:10

2020-11-17 11:10:42

MySQL数据库索引

2011-08-05 14:16:47

Objective-C 变量 方法

2015-07-02 16:10:11

UIStackViewiOS 9

2023-03-19 11:42:19

React新官方文档

2011-04-19 17:06:24

bada控件bada

2011-12-22 12:37:17

JavaJFreeChart

2009-07-17 14:55:38

ibatis官方

2010-01-19 14:46:04

jQuery 1.4

2020-12-01 15:54:08

鸿蒙构建系统

2021-11-15 10:02:16

Python命令技巧

2010-05-26 10:58:02

SVN管理
点赞
收藏

51CTO技术栈公众号