跳到主要内容

开发准备

创建游戏

若在华为应用市场发布游戏,或使用AGC控制台提供的服务,需要前往AGC控制台创建游戏类应用,具体操作请参见创建项目创建HarmonyOS应用。其中:

  • “应用类型”:选择“HarmonyOS应用”。
  • “应用分类”:选择“游戏”。

申请近场快传开放能力

基于安全考虑,系统侧对近场快传功能做了权限保护处理,使用相关接口开发者需先提交“近场快传”能力开关的申请,在申请通过后,再使用该能力开关。

  1. 登录AppGallery Connect,点击“开发与服务”。在项目列表中找到项目,并点击选择需要申请权限的游戏。

  2. 在“项目设置”页面,选择“开放能力管理”页签,开始为游戏申请近场快传开放能力。

  3. 搜索“近场快传”,点击对应能力后面的“申请”,打开“新建业务申请”窗口。

  4. 在“新建业务申请”窗口填写申请信息,然后点击“提交”。

    配置项必填/选填说明
    申请原因必填申请近场快传的原因,请按照模板填写相关信息,字数不超过512个字符。
    上传附件选填仅可上传1个附件,大小不超过500MB。支持文本、表格、图片、视频、压缩包格式。
  5. 进入互动中心页面,可以看到申请已提交的消息。

    返回“开放能力管理”页面,近场快传显示“申请中”,1-3个工作日反馈申请结果。

  6. 申请审批通过后,互动中心将会发送通知给您,同时近场快传的能力开关会为您自动开启,“申请中”也会变为置灰显示的“申请”。至此,游戏已成功开启近场快传开放能力。

生成签名证书

数字证书和Profile文件等签名信息可以确保游戏的完整性,请参见配置签名信息完成配置。

配置APP ID和相关权限

  1. 登录AppGallery Connect平台,在“开发与服务”中选择目标应用,获取“项目设置 > 常规 > 应用”的APP ID

  2. 在工程的entry模块module.json5文件中,新增metadata并配置app_id,同时新增requestPermissions并配置如下权限。

    "module": {
    "name": "entry",
    "type": "entry",
    "description": "xxxx",
    "mainElement": "xxxx",
    "deviceTypes": [
    "phone"
    ],
    "deliveryWithInstall": true,
    "pages": "$profile:main_pages",
    "abilities": [],
    "metadata": [ // 配置如下信息
    {
    "name": "app_id",
    "value": "xxxxxx" // 配置为前面步骤中获取的APP ID
    }
    ],
    "requestPermissions": [ // 配置权限
    {
    "name": "ohos.permission.INTERNET" // 允许使用Internet网络权限
    },
    {
    "name": "ohos.permission.GET_NETWORK_INFO" // 允许应用获取数据网络信息权限
    },
    {
    "name": "ohos.permission.SET_NETWORK_INFO" // 允许应用配置数据网络权限
    },
    {
    "name": "ohos.permission.DISTRIBUTED_DATASYNC", // 允许不同设备间的数据交换权限
    "reason": "$string:distributed_permission",
    "usedScene": {
    "abilities": [
    "EntryAbility"
    ],
    "when": "inuse"
    }
    }
    ]
    }