在第一次使用Mobile SDK开发的应用程序时,需要将密钥和应用程序信息在大疆的网站上注册,注册成功后才可以正常使用Mobile SDK的各项功能。申请密钥前,需要开发者准备一些关于应用程序的备案信息,包括应用程序名称、包标识符、应用类型、描述信息等。然后,我们按照以下步骤申请应用程序密钥。
(1)打开应用程序管理页面。
在大疆开发者网站的用户中心中,单击左侧的【应用】选项即可打开应用程序管理页面(或通过http://developer.dji.com/user/apps/访问),如图2-19所示。
图2-19 应用程序管理页面
❀ 本节以中文语言为例,在大疆开发者网站页面的右下角“ ”即可将页面切换为英文等其他语言。
(2)创建应用程序。
单击应用程序管理页面右上角的【创建应用】按钮,弹出创建应用程序对话框,如图2-20所示。
图2-20 创建应用程序对话框
在对话框中输入以下内容。
● SDK(类型):选择应用程序所使用的SDK类型,包括Mobile SDK、Onboard SDK和Windows SDK等。
● App名称(App Name):输入应用程序名称,可以与移动应用程序的名称稍有不同。
● 开发平台(Software Platform):选择应用程序的运行平台,包括Android和iOS两个选项。
● 应用程序包标识符(Package Name):输入应用程序的包标识符,用于识别应用程序。对于Android应用程序,包识别符即为包名,可在AndroidManifest.xml文件中定义,如图2-21所示。对于iOS应用程序来说,包标识符通过项目属性中的“Bundle Identifier”选项定义,如图2-22所示。
图2-21 Android应用程序的包名定义
图2-22 iOS应用程序的包名定义
● 分类(Category):输入应用程序的应用类别,包括农业应用(Agricultrual applications)、测绘制图(Cartography)、灾害探查(Disaster probe)、运动追踪(Motion tracking)、电影摄制(Film shooting)、动物饲养(Animal feeding)、自然探索(Nature discovery)、电力巡检(Power line patrol)与其他(Other)等。选择其他时,需要手动输入类别。
● 描述(Description):输入应用程序的相关描述。
在本节中,“SDK”选择为“Mobile SDK”,其余的选项按照上述说明如实填写,单击【创建】按钮。此时,大疆开发者网站会向DJI的注册邮箱中发送激活链接,如图2-23所示。打开激活链接后即可完成激活。
图2-23 通过邮箱激活创建的App
(3)查看已注册的应用程序及其密钥。
在大疆开发者网站中单击“Apps”链接后即可显示所有注册的应用程序。单击左上方的【ALL SDK】按钮,即可在“显示全部SDK应用程序(ALL SDK)”、“显示Mobile SDK应用程序”、“显示Onboard SDK应用程序”和“显示Windows SDK应用程序”之间切换。
单击【BUTTON VIEW】,即可将已经注册的应用程序在按钮视图(BUTTON VIEW)和列表视图(LIST VIEW)之间进行切换。在列表视图下,可显示所有注册的应用程序的SDK类型(SDK Type)、应用程序名称(App Name)、应用程序ID(App ID)、MFi状态(MFi Status)和详细信息(Detail)。其中,没有通过邮箱激活的应用程序以灰色按钮【NOT ACTIVATED】显示,已经通过邮箱激活的应用程序可单击【查看详情】按钮查看详情,如图2-24所示。
图2-24 在大疆开发者网站查看已注册的应用程序列表
单击刚刚注册的应用程序右侧的【查看详情】按钮即可查看其详细信息。如图2-25所示,在应用程序详细信息中,“APP密钥”项目右侧的字符串即为该应用程序的密钥,此时需要通过复制粘贴的方式将其放入Mobile SDK应用程序项目的指定位置(请参见“第3章第一个Mobile SDK应用程序”)。
图2-25 已注册的应用程序信息查看页面