快速接入

快速接入

1、申请 sdk 登录帐号

确保您已完成 sdk 使用权限及账号的申请注册，未完成请先申请帐号

2、集成环境说明

2.1开发环境说明

最低支持 Harmony OS 版本：5.0.0（12）

IDE版本要求

DevEco Studio 5.1.1 Release
Build #DS-233.14475.28.36.511830
Build Version: 5.1.1.830, built on August 4, 2025
Runtime version: 17.0.12+1-b1087.25 amd64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
Windows 11.0
GC: G1 Young Generation, G1 Old Generation
Memory: 4096M
Cores: 32
Registry:
  idea.plugins.compatible.build=IC-233.14475.28

3、绑定应用信息

3.1、查询配置

进入开发设置-点击查看应用（新应用可点击，创建应用）

3.2、应用初始化必要信息

APPkey：用于标识客户身份，在网络请求中会以某种形式传输

App Secretkey：它的作用是对客户方发起的请求进行数字签名，保证该请求是来自指定客户的请求，并且是合法的有效的。移动端 SDK 使用

安全码SHA256：对应APP应用cer签名文件对应的SHA256编码

包名：对应APP应用包名

3.3、应用包名获取

在应用app.json5 文件中获取bundleName，填写到鸿蒙SDK包名处并保存。

3.4、安全码SHA256

SDK进行接口验签需要使用签名信息，签名信息获取方法如下。

根据您APP配置的签名，找到cer文件
应用包名获取

将cer文件进行拷贝，然后保留最后一个-----BEGIN CERTIFICATE-----到-----END CERTIFICATE-----内容，删除之前面两个CERTIFICATE。

使用命令行获取签名文件的SHA256信息。示例中使用openssl 进行获取。

将0E:E5:2E:78:16:1D:4B:59:13:58:DC:08:0E:43:68:4F:73:06:AB:A0:43:B0:1E:16:72:9C:B6:CD:84:B2:F8:FC值粘贴到Harmony-SDK 签名值的安全码SHA256处并保存。

4、SDK 集成准备

4.1、使用 ohpm引入SDK

在集成SDK模块的oh-package.json5文件中引入@vhall/vhall_live

{
  "name": "watchkit",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "Index.ets",
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "@vhall/vhall_live": "1.2.0",//SDK基础+观看模块
    "@vhall/vhall_rtc": "1.2.0",//互动连麦
    "@vhall/vhall_pusher": "1.2.0",//直播推流
    "@vhall/vhall_beauty": "1.2.0",//美颜
    "@ohos/danmakuflamemaster": "2.0.1",
    "@esky/barrage": "1.0.6"
  }
}

执行ohpm install @vhall/vhall_live

4.2、项目必要配置信息

在引入应用module.json5 配置网络权限

{
  "module": {
    "name": "watchKit",
    "type": "har",
    "requestPermissions": [
      {"name": "ohos.permission.INTERNET"},
      {
        "name": "ohos.permission.READ_MEDIA",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        },
        "reason":"$string:read_media"
      },
      {
        "name": "ohos.permission.WRITE_MEDIA",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        },
        "reason":"$string:write_media"
      },
      {
        "name": "ohos.permission.WRITE_IMAGEVIDEO",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        },
        "reason":"$string:write_imagevideo"
      },
    ],
    "deviceTypes": [
      "default"
    ],
    "routerMap": "$profile:route_map"
  }
}

4.3、SDK引入获取版本号

//导入包
import { VHSaaSDK, VHCallBack } from '@vhall/vhall_live'

@Entry
@Component
struct Index {

  aboutToAppear(): void {
    //获取SDK版本号
    VHSaaSDK.getInstance().getVersion();
  }

  build() {
    Navigation(this.pathStack) {
      
    }
    .hideToolBar(true)
    .hideTitleBar(true)
    .width('100%')
    .height('100%')
    .mode(NavigationMode.Stack)
    .id('Login')
  }

}

5、基本流程示例

主要通过示例展示进入直播前用户需要进行初始化、活动配置信息获取、直播前状态处理。

1、申请 sdk 登录帐号#

2、集成环境说明#

2.1开发环境说明#

3、绑定应用信息#

3.1、查询配置#

3.2、应用初始化必要信息#

3.3、应用包名获取#

3.4、安全码SHA256#

4、SDK 集成准备#

4.1、使用 ohpm引入SDK#

4.2、项目必要配置信息#

4.3、SDK引入获取版本号#

5、基本流程示例#