1# deviceinfo.h 2 3## 概述 4 5声明用于查询终端设备信息的API。 6 7**库：** libdeviceinfo_ndk.z.so 8 9**系统能力：** SystemCapability.Startup.SystemInfo 10 11**起始版本：** 10 12 13**相关模块：** [DeviceInfo](capi-deviceinfo.md) 14 15## 汇总 16 17### 函数 18 19| 名称 | 描述 | 20| -- | -- | 21| [const char *OH_GetDeviceType(void)](#oh_getdevicetype) | 获取设备类型。 | 22| [const char *OH_GetManufacture(void)](#oh_getmanufacture) | 获取设备制造商。 | 23| [const char *OH_GetBrand(void)](#oh_getbrand) | 获取设备品牌。 | 24| [const char *OH_GetMarketName(void)](#oh_getmarketname) | 获取外部产品系列。 | 25| [const char *OH_GetProductSeries(void)](#oh_getproductseries) | 获取产品系列。 | 26| [const char *OH_GetProductModel(void)](#oh_getproductmodel) | 获取认证型号。 | 27| [const char *OH_GetSoftwareModel(void)](#oh_getsoftwaremodel) | 获取内部软件子型号。 | 28| [const char *OH_GetHardwareModel(void)](#oh_gethardwaremodel) | 获取硬件版本号。 | 29| [const char *OH_GetBootloaderVersion(void)](#oh_getbootloaderversion) | 获取Bootloader版本号。 | 30| [const char *OH_GetAbiList(void)](#oh_getabilist) | 获取应用二进制接口（Abi）。 | 31| [const char *OH_GetSecurityPatchTag(void)](#oh_getsecuritypatchtag) | 获取安全补丁级别。 | 32| [const char *OH_GetDisplayVersion(void)](#oh_getdisplayversion) | 获取产品版本。 | 33| [const char *OH_GetIncrementalVersion(void)](#oh_getincrementalversion) | 获取差异版本。 | 34| [const char *OH_GetOsReleaseType(void)](#oh_getosreleasetype) | 获取系统的发布类型。 | 35| [const char *OH_GetOSFullName(void)](#oh_getosfullname) | 获取完整的系统版本名。 | 36| [int OH_GetSdkApiVersion(void)](#oh_getsdkapiversion) | 获取系统软件API版本。 | 37| [int OH_GetFirstApiVersion(void)](#oh_getfirstapiversion) | 获取首个版本系统软件API版本。 | 38| [const char *OH_GetVersionId(void)](#oh_getversionid) | 获取版本ID。 | 39| [const char *OH_GetBuildType(void)](#oh_getbuildtype) | 获取系统的构建类型。 | 40| [const char *OH_GetBuildUser(void)](#oh_getbuilduser) | 获取系统的构建用户。 | 41| [const char *OH_GetBuildHost(void)](#oh_getbuildhost) | 获取系统的构建主机。 | 42| [const char *OH_GetBuildTime(void)](#oh_getbuildtime) | 获取系统的构建时间。 | 43| [const char *OH_GetBuildRootHash(void)](#oh_getbuildroothash) | 获取系统的构建版本Hash。 | 44| [const char *OH_GetDistributionOSName(void)](#oh_getdistributionosname) | 获取ISV发行系统版本名称。独立软件供应商（ISV）可以使用自己定义的系统名称。 | 45| [const char *OH_GetDistributionOSVersion(void)](#oh_getdistributionosversion) | 获取ISV发行版系统版本号。 | 46| [int OH_GetDistributionOSApiVersion(void)](#oh_getdistributionosapiversion) | 获取ISV发行版系统api版本。 | 47| [const char *OH_GetDistributionOSReleaseType(void)](#oh_getdistributionosreleasetype) | 获取ISV发行版系统类型。 | 48 49## 函数说明 50 51### OH_GetDeviceType() 52 53``` 54const char *OH_GetDeviceType(void) 55``` 56 57**描述** 58 59获取设备类型。 60 61**起始版本：** 10 62 63**返回：** 64 65| 类型 | 说明 | 66| -- | -- | 67| const char | "phone"(或"default")<br> "wearable",<br> "liteWearable",<br> "tablet",<br> "tv",<br> "car",<br> "smartVision"。 | 68 69### OH_GetManufacture() 70 71``` 72const char *OH_GetManufacture(void) 73``` 74 75**描述** 76 77获取设备制造商。 78 79**起始版本：** 10 80 81**返回：** 82 83| 类型 | 说明 | 84| -- | -- | 85| const char* | 字符串类型的设备制造商。 | 86 87### OH_GetBrand() 88 89``` 90const char *OH_GetBrand(void) 91``` 92 93**描述** 94 95获取设备品牌。 96 97**起始版本：** 10 98 99**返回：** 100 101| 类型 | 说明 | 102| -- | -- | 103| const char* | 字符串类型的设备品牌。 | 104 105### OH_GetMarketName() 106 107``` 108const char *OH_GetMarketName(void) 109``` 110 111**描述** 112 113获取外部产品系列。 114 115**起始版本：** 10 116 117**返回：** 118 119| 类型 | 说明 | 120| -- | -- | 121| const char* | 字符串类型的外部产品系列。 | 122 123### OH_GetProductSeries() 124 125``` 126const char *OH_GetProductSeries(void) 127``` 128 129**描述** 130 131获取产品系列。 132 133**起始版本：** 10 134 135**返回：** 136 137| 类型 | 说明 | 138| -- | -- | 139| const char* | 字符串类型的产品系列。 | 140 141### OH_GetProductModel() 142 143``` 144const char *OH_GetProductModel(void) 145``` 146 147**描述** 148 149获取认证型号。 150 151**起始版本：** 10 152 153**返回：** 154 155| 类型 | 说明 | 156| -- | -- | 157| const char* | 字符串类型的认证型号。 | 158 159### OH_GetSoftwareModel() 160 161``` 162const char *OH_GetSoftwareModel(void) 163``` 164 165**描述** 166 167获取内部软件子型号。 168 169**起始版本：** 10 170 171**返回：** 172 173| 类型 | 说明 | 174| -- | -- | 175| const char* | 字符串类型的内部软件子型号。 | 176 177### OH_GetHardwareModel() 178 179``` 180const char *OH_GetHardwareModel(void) 181``` 182 183**描述** 184 185获取硬件版本号。 186 187**起始版本：** 10 188 189**返回：** 190 191| 类型 | 说明 | 192| -- | -- | 193| const char* | 字符串类型的硬件版本号。 | 194 195### OH_GetBootloaderVersion() 196 197``` 198const char *OH_GetBootloaderVersion(void) 199``` 200 201**描述** 202 203获取Bootloader版本号。 204 205**起始版本：** 10 206 207**返回：** 208 209| 类型 | 说明 | 210| -- | -- | 211| const char* | 字符串类型的Bootloader版本号。 | 212 213### OH_GetAbiList() 214 215``` 216const char *OH_GetAbiList(void) 217``` 218 219**描述** 220 221获取应用二进制接口（Abi）。 222 223**起始版本：** 10 224 225**返回：** 226 227| 类型 | 说明 | 228| -- | -- | 229| const char* | 字符串类型的应用二进制接口（Abi）。 | 230 231### OH_GetSecurityPatchTag() 232 233``` 234const char *OH_GetSecurityPatchTag(void) 235``` 236 237**描述** 238 239获取安全补丁级别。 240 241**起始版本：** 10 242 243**返回：** 244 245| 类型 | 说明 | 246| -- | -- | 247| const char* | 字符串类型的安全补丁级别。 | 248 249### OH_GetDisplayVersion() 250 251``` 252const char *OH_GetDisplayVersion(void) 253``` 254 255**描述** 256 257获取产品版本。 258 259**起始版本：** 10 260 261**返回：** 262 263| 类型 | 说明 | 264| -- | -- | 265| const char* | 字符串类型的产品版本。 | 266 267### OH_GetIncrementalVersion() 268 269``` 270const char *OH_GetIncrementalVersion(void) 271``` 272 273**描述** 274 275获取差异版本。 276 277**起始版本：** 10 278 279**返回：** 280 281| 类型 | 说明 | 282| -- | -- | 283| const char* | 字符串类型的获取差异版本。 | 284 285### OH_GetOsReleaseType() 286 287``` 288const char *OH_GetOsReleaseType(void) 289``` 290 291**描述** 292 293获取系统的发布类型。 294 295**起始版本：** 10 296 297**返回：** 298 299| 类型 | 说明 | 300| -- |-----------------------------------------------------------------------------------------| 301| const char* | 操作系统发布类别包括"release"、"Beta"和"Canary"。<br> 具体的发布类型可能是"release"，"Beta1"，或其他类似的。 | 302 303### OH_GetOSFullName() 304 305``` 306const char *OH_GetOSFullName(void) 307``` 308 309**描述** 310 311获取完整的系统版本名。 312 313**起始版本：** 10 314 315**返回：** 316 317| 类型 | 说明 | 318| -- | -- | 319| const char* | 字符串类型的完整的系统版本名。 | 320 321### OH_GetSdkApiVersion() 322 323``` 324int OH_GetSdkApiVersion(void) 325``` 326 327**描述** 328 329获取系统软件API版本。 330 331**起始版本：** 10 332 333**返回：** 334 335| 类型 | 说明 | 336| -- | -- | 337| int | 系统软件API版本。 | 338 339### OH_GetFirstApiVersion() 340 341``` 342int OH_GetFirstApiVersion(void) 343``` 344 345**描述** 346 347获取首个版本系统软件API版本。 348 349**起始版本：** 10 350 351**返回：** 352 353| 类型 | 说明 | 354| -- | -- | 355| int | 首个版本系统软件API版本。 | 356 357### OH_GetVersionId() 358 359``` 360const char *OH_GetVersionId(void) 361``` 362 363**描述** 364 365获取版本ID。 366 367**起始版本：** 10 368 369**返回：** 370 371| 类型 | 说明 | 372| -- | -- | 373| const char* | 字符串类型的版本ID。 | 374 375### OH_GetBuildType() 376 377``` 378const char *OH_GetBuildType(void) 379``` 380 381**描述** 382 383获取系统的构建类型。 384 385**起始版本：** 10 386 387**返回：** 388 389| 类型 | 说明 | 390| -- | -- | 391| const char* | 字符串类型的系统的构建类型。 | 392 393### OH_GetBuildUser() 394 395``` 396const char *OH_GetBuildUser(void) 397``` 398 399**描述** 400 401获取系统的构建用户。 402 403**起始版本：** 10 404 405**返回：** 406 407| 类型 | 说明 | 408| -- | -- | 409| const char* | 字符串类型的系统的构建用户。 | 410 411### OH_GetBuildHost() 412 413``` 414const char *OH_GetBuildHost(void) 415``` 416 417**描述** 418 419获取系统的构建主机。 420 421**起始版本：** 10 422 423**返回：** 424 425| 类型 | 说明 | 426| -- | -- | 427| const char* | 字符串类型的系统的构建主机。 | 428 429### OH_GetBuildTime() 430 431``` 432const char *OH_GetBuildTime(void) 433``` 434 435**描述** 436 437获取系统的构建时间。 438 439**起始版本：** 10 440 441**返回：** 442 443| 类型 | 说明 | 444| -- | -- | 445| const char* | 字符串类型的系统的构建时间。 | 446 447### OH_GetBuildRootHash() 448 449``` 450const char *OH_GetBuildRootHash(void) 451``` 452 453**描述** 454 455获取系统的构建版本Hash。 456 457**起始版本：** 10 458 459**返回：** 460 461| 类型 | 说明 | 462| -- | -- | 463| const char* | 字符串类型的系统的构建版本Hash。 | 464 465### OH_GetDistributionOSName() 466 467``` 468const char *OH_GetDistributionOSName(void) 469``` 470 471**描述** 472 473获取ISV发行系统版本名称。独立软件供应商（ISV）可以使用自己定义的系统名称。 474 475**起始版本：** 10 476 477**返回：** 478 479| 类型 | 说明 | 480| -- | -- | 481| const char* | ISV发行系统版本名称。<br> 如果没有指定ISV，它将返回一个空字符串。 | 482 483### OH_GetDistributionOSVersion() 484 485``` 486const char *OH_GetDistributionOSVersion(void) 487``` 488 489**描述** 490 491获取ISV发行版系统版本号。 492 493**起始版本：** 10 494 495**返回：** 496 497| 类型 | 说明 | 498| -- |----------------------------------------------------------------------------| 499| const char* | ISV发行版系统版本号。<br> 如果没有指定ISV，它将返回与[OH_GetOSFullName](#oh_getosfullname)相同的值。 | 500 501### OH_GetDistributionOSApiVersion() 502 503``` 504int OH_GetDistributionOSApiVersion(void) 505``` 506 507**描述** 508 509获取ISV发行版系统api版本。 510 511**起始版本：** 10 512 513**返回：** 514 515| 类型 | 说明 | 516| -- | -- | 517| int | ISV发行版系统api版本。<br> 如果没有指定ISV，它将返回与[OH_GetOSFullName](#oh_getosfullname)相同的值。 | 518 519### OH_GetDistributionOSReleaseType() 520 521``` 522const char *OH_GetDistributionOSReleaseType(void) 523``` 524 525**描述** 526 527获取ISV发行版系统类型。 528 529**起始版本：** 10 530 531**返回：** 532 533| 类型 | 说明 | 534| -- |---------------------------------------------------------------------------------| 535| const char | ISV发行版系统类型。<br> 如果没有指定ISV，它将返回与[OH_GetOsReleaseType](#oh_getosreleasetype)相同的值。 | 536 537 538