HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型
HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型 如下图

这种类型一共有多少种,有文档专门介绍这个类型都有什么吗
更多关于HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型的实战教程也可以访问 https://www.itying.com/category-93-b0.html
背景知识:
在ArkTs中基础类型有:
-
数字类型(Number Types)
let age: number = 25;
-
字符串类型(String)
let firstName: string = 'zhangsan';
-
布尔类型(Boolean)
let isActive: boolean = true/false;
-
数组类型(Array)
let numbers: number[] = [1, 2, 3, 4, 5];
-
元组类型(Tuple)
let userInfo: [string, number, boolean] = ['John', 30, true];
-
枚举类型(Enum)
enum Direction {
Up, // 0
Down, // 1
Left, // 2
Right // 3
}
等
上图中写的是 MakeCallOptions 是一个对象类型。

注意:一般这种有超链接的可以直接点击过去查看参数属性。
更多关于HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
这个“类型”其实就是:
ArkTS / TypeScript 类型定义
鸿蒙官方文档里的参数表:
- string
- number
- boolean
- Array
- Promise
- Callback
- Want
- Context
- BusinessError
- xxxOptions
- xxxInfo
- xxxResult
这些本质上都是:
ArkTS 类型
或者:
HarmonyOS SDK 自定义对象类型
你截图里的 MakeCallOptions 是什么?
例如:
makeCall(phoneNumber: string, options?: MakeCallOptions)
这里:
MakeCallOptions
不是基础类型。
而是:
一个接口(interface)/ 类型定义
点进去一般会看到:
interface MakeCallOptions {
accountId?: number
videoState?: number
}
类似这样。
你问“这种类型一共有多少种”
严格来说:
没有固定数量
因为:
HarmonyOS 每个 Kit 都会定义自己的类型。
比如:
- ArkUI
- AbilityKit
- TelephonyKit
- MediaKit
- LocationKit
都会有大量:
xxxOptions
xxxInfo
xxxResult
xxxConfig
xxxCallback
类型。
总量非常大。
官方其实没有一个“总类型大全”
因为:
类型是分散在各个 Kit 文档中的
例如:
电话服务
MakeCallOptions
CallState
DialParams
相机
CameraPosition
PhotoProfile
PreviewOutput
网络
HttpRequestOptions
BusinessError
但官方有“类型定义”的规律
你会发现大多数类型命名都类似:
| 类型后缀 | 含义 |
|---|---|
| Options | 配置参数 |
| Info | 信息对象 |
| Result | 返回结果 |
| Callback | 回调 |
| Config | 配置 |
| Context | 上下文 |
| Params | 参数 |
| Data | 数据 |
| Event | 事件 |
| State | 状态 |
| Manager | 管理器 |
最核心的其实就两大类
1. 基础类型(ArkTS/TS)
例如:
string
number
boolean
object
Array<T>
Promise<T>
Map
Set
这些是:
TypeScript 原生类型
2. HarmonyOS SDK 类型
例如:
Want
BusinessError
UIContext
AbilityContext
这些是:
鸿蒙SDK自己定义的类型
最推荐的查看方式(非常重要)
方法1:直接点蓝色类型名(推荐)
你截图里:
MakeCallOptions
蓝色可点击。
点进去:
就会进入:
该类型定义页
官方文档就是这么设计的。
方法2:查看 .d.ts 声明文件(高级开发推荐)
DevEco 安装后:
SDK 内部其实全是:
.d.ts
声明文件。
例如:
api/@kit.TelephonyKit.d.ts
里面会有:
export interface MakeCallOptions
这才是真正完整定义。
方法3:IDE 跳转(最方便)
在 DevEco Studio:
MakeCallOptions
按:
Ctrl + 鼠标左键
或者:
Ctrl + B
直接跳类型定义。
这才是鸿蒙开发最常用方式。
你可能还会看到这些类型
联合类型
string | undefined
表示:
可能为空
泛型
Array<string>
Promise<Result>
回调类型
AsyncCallback<string>
枚举类型
AudioState
NetworkType
一个很关键的认知
鸿蒙官方文档:
本质就是 TypeScript API 文档
因为 ArkTS 本身就是:
TypeScript 超集
所以:
你学鸿蒙 API,
本质也在学:
TypeScript 类型系统
一句话总结
你截图里的:
MakeCallOptions
属于:
HarmonyOS SDK 自定义类型
不是基础类型。
这类类型没有统一总表,而是:
分散定义在各个 Kit 的 API 文档和 .d.ts 声明文件中
最推荐:
直接点击类型名查看定义
或者:
在 DevEco Studio 里 Ctrl+点击跳转
这是鸿蒙开发最标准的查类型方式。
ArkTS基于TypeScript。如果就是入门练习,可以在TS strict模式下练习。
ArkTS关于类型,介绍比较简单,本身也不多。《类型》。
也有人总结:《arkts有几种数据类型》。
这个没有专门的文档介绍的,我给你简单说一下吧。一般来说,API 文档里的类型分两类:
一种是 ArkTS(鸿蒙开发语言)的原生类型,比如你截图里的 string 就属于这一类:
string:字符串
number:数字(含整数、浮点数)
boolean:布尔值(true/false)
Array<T>:数组(比如 string[]、number[])
object:通用对象
null / undefined
还有枚举、联合类型(比如 string | number)、泛型等
详细的,你参考这个文档
ArkTS语言介绍-学习ArkTS语言-基础入门 - 华为HarmonyOS开发者
第二种就是API 自定义的类型
就是你截图里的 MakeCallOptions 这种,它们是某个 API 模块自己定义的结构体 / 接口类型,只在这个模块里用。
每个 API 模块(比如 @ohos.telephony.call、@ohos.web.webview)都会定义自己的专属类型
比如 MakeCallOptions 是 call 模块为 makeCall 接口定义的参数结构体
这类类型没有全局总数,每个模块都可能新增,所以没有 “总共有多少种” 的说法。每个 API 模块的文档里,都会单独列出它的自定义类型
您好,关于string等基础类型的介绍在ArkTS开发文档里有:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/introduction-to-arkts
像那些MakeCallOptions等都属于基础类型实际应用里的名称,例如它就是某个自定义的class类而已。
你不必刻意学习某个类型到底是什么结构,只需要用的时候按照开发文档里的参数使用就行了。
官方文档参数表格中的“类型”字段,指该参数在ArkTS(鸿蒙Next应用开发语言)中允许的数据类型。常见类型包括:string(字符串)、number(数字)、boolean(布尔)、Object、Array、undefined、null,以及鸿蒙特有的Resource(资源引用)、ImageSource(图片源)等。类型名称对应TypeScript语法,用于约束输入值的格式和范围。
HarmonyOS Next 文档里参数表格中的类型,并没有一个“一共多少种”的固定总数——因为类型是随 API 不断扩展的,每个模块会定义专属的类型,但基础/通用类型的集合是有限的。
官方有专门的文档介绍通用类型:在 HarmonyOS Next API参考 的“通用参数类型”“Promise与Callback”或“接口/类型”章节,会集中说明 string、number、boolean、Array<T>、Promise<T>、Callback<T>、BusinessError、ErrorCallback 等基础与通用类型。某些模块还会有自己的枚举、接口,这些一般随模块自身的 API 说明呈现。
建议直接查看对应 API 参考页的“概述”或左侧目录的“数据类型”部分,可以快速定位当前可用类型及说明。

