前言

HarmonyOS 提供了一個強大的 API 集，方便開發者獲取設備的硬件和軟件信息。通過 @kit.BasicServicesKit 模塊的 deviceInfo 接口，開發者可以訪問設備的型號、品牌、系統版本等詳細信息。本文將詳細介紹如何使用這些接口獲取設備信息，並提供一個完整的 Demo 示例代碼。

一、引入模塊和基本設備信息的獲取

首先，引入 @kit.BasicServicesKit 模塊，然後通過 deviceInfo 接口獲取設備的基本信息。這些信息包括設備類型、製造商、品牌等。以下是獲取設備基本信息的代碼示例：

import { deviceInfo } from '@kit.BasicServicesKit';

// 獲取設備類型
let deviceTypeInfo: string = deviceInfo.deviceType;
console.info('Device Type: ' + deviceTypeInfo);

// 獲取設備製造商信息
let manufactureInfo: string = deviceInfo.manufacture;
console.info('Manufacture: ' + manufactureInfo);

// 獲取品牌信息
let brandInfo: string = deviceInfo.brand;
console.info('Brand: ' + brandInfo);

// 獲取市場名稱
let marketNameInfo: string = deviceInfo.marketName;
console.info('Market Name: ' + marketNameInfo);

二、設備硬件和系統版本信息的獲取

HarmonyOS 提供了詳細的硬件和系統版本信息，包括設備系列、硬件型號、軟件版本、OS 版本等。這些信息有助於開發者根據設備的特性做出優化適配。以下是獲取設備硬件和系統版本信息的代碼示例：

// 獲取設備系列
let productSeriesInfo: string = deviceInfo.productSeries;
console.info('Product Series: ' + productSeriesInfo);

// 獲取產品型號
let productModelInfo: string = deviceInfo.productModel;
console.info('Product Model: ' + productModelInfo);

// 獲取系統顯示版本
let displayVersionInfo: string = deviceInfo.displayVersion;
console.info('Display Version: ' + displayVersionInfo);

// 獲取增量版本
let incrementalVersionInfo: string = deviceInfo.incrementalVersion;
console.info('Incremental Version: ' + incrementalVersionInfo);

// 獲取 OS 全名
let osFullNameInfo: string = deviceInfo.osFullName;
console.info('OS Full Name: ' + osFullNameInfo);

三、獲取安全相關的設備信息

在某些應用場景中，瞭解設備的安全補丁和系統版本信息是非常重要的。HarmonyOS 提供了安全補丁標籤、引導加載程序版本等信息，便於開發者確保應用運行在安全的設備環境上。

// 獲取安全補丁標籤
let securityPatchTagInfo: string = deviceInfo.securityPatchTag;
console.info('Security Patch Tag: ' + securityPatchTagInfo);

// 獲取引導加載程序版本
let bootloaderVersionInfo: string = deviceInfo.bootloaderVersion;
console.info('Bootloader Version: ' + bootloaderVersionInfo);

四、獲取網絡狀態信息

設備的網絡狀態對於某些功能的實現至關重要。HarmonyOS 提供了接口幫助開發者判斷設備是否連接到網絡。以下是獲取當前網絡狀態的示例代碼：

import { network } from '@kit.NetworkKit';

function checkNetworkConnection() {
    let isNetworkConnected: boolean = network.isConnected;
    console.info('Network Connected: ' + isNetworkConnected);
}
checkNetworkConnection();

五、完整 Demo 代碼

我們利用 HarmonyOS 提供的 deviceInfo 和 network 兩個模塊，來獲取設備的基礎信息、系統版本信息和網絡連接狀態。以下是 Demo 的詳細解釋。

1. 導入所需模塊

首先，我們需要引入兩個模塊：

• @kit.BasicServicesKit 提供了 deviceInfo 對象，用於訪問設備的基本信息，如設備類型、製造商、品牌、系統版本等。
• @kit.NetworkKit 提供了 network 對象，用於檢測當前設備的網絡連接狀態。

import { deviceInfo } from '@kit.BasicServicesKit';
import { network } from '@kit.NetworkKit';

2. 獲取設備基本信息

getDeviceInfo 函數用於獲取和輸出設備的各種信息，包括類型、製造商、品牌、系統版本等。

代碼解析

• deviceInfo.deviceType: 獲取設備的類型，如手機、平板等。
• deviceInfo.manufacture: 獲取設備的製造商名稱。
• deviceInfo.brand: 獲取設備的品牌，如華為。
• deviceInfo.marketName: 獲取設備在市場上的商品名稱。

function getDeviceInfo() {
    console.info('--- Device Information ---');
    console.info('Device Type: ' + deviceInfo.deviceType);
    console.info('Manufacture: ' + deviceInfo.manufacture);
    console.info('Brand: ' + deviceInfo.brand);
    console.info('Market Name: ' + deviceInfo.marketName);

示例輸出：

Device Type: Phone
Manufacture: Huawei
Brand: HUAWEI
Market Name: P50 Pro

• deviceInfo.productSeries: 獲取設備的系列信息，例如 P 系列、Mate 系列等。
• deviceInfo.productModel: 獲取設備的產品型號。
• deviceInfo.displayVersion: 獲取設備的顯示版本，這個信息通常用來表示操作系統的整體版本。
• deviceInfo.incrementalVersion: 獲取增量版本，用於區別小版本更新。
• deviceInfo.osFullName: 獲取操作系統的完整名稱。

    console.info('Product Series: ' + deviceInfo.productSeries);
    console.info('Product Model: ' + deviceInfo.productModel);
    console.info('Display Version: ' + deviceInfo.displayVersion);
    console.info('Incremental Version: ' + deviceInfo.incrementalVersion);
    console.info('OS Full Name: ' + deviceInfo.osFullName);

示例輸出：

Product Series: P Series
Product Model: P50
Display Version: HarmonyOS 3.0
Incremental Version: 123456
OS Full Name: HarmonyOS

• deviceInfo.securityPatchTag: 獲取設備的安全補丁標籤，用於瞭解設備的安全更新狀態。
• deviceInfo.bootloaderVersion: 獲取引導加載程序版本，用於設備的啓動和安全相關的操作。

    console.info('Security Patch Tag: ' + deviceInfo.securityPatchTag);
    console.info('Bootloader Version: ' + deviceInfo.bootloaderVersion);
}

示例輸出：

Security Patch Tag: 2024-09-01
Bootloader Version: V1.0.0

3. 檢測網絡連接狀態

checkNetworkConnection 函數用於檢測設備的網絡連接狀態。通過 network.isConnected 屬性，判斷設備是否已連接到網絡，返回一個布爾值，true 表示連接，false 表示未連接。

function checkNetworkConnection() {
    console.info('--- Network Connection Status ---');
    let isNetworkConnected: boolean = network.isConnected;
    console.info('Network Connected: ' + isNetworkConnected);
}

示例輸出：

Network Connected: true

4. 執行函數

最後，調用 getDeviceInfo 和 checkNetworkConnection 函數來輸出設備信息和網絡狀態：

getDeviceInfo();
checkNetworkConnection();

總結

本文展示瞭如何在 HarmonyOS 中獲取設備的詳細信息，包括設備類型、品牌、系列、產品型號、系統版本以及網絡連接狀態。HarmonyOS 提供的 deviceInfo 和 network 模塊使得設備信息和網絡狀態的獲取變得簡便。在實際開發中，這些信息對於設備的適配、功能的優化以及安全檢查都至關重要。

通過這些接口，開發者可以動態地瞭解設備的特性和當前網絡狀態，從而實現更智能化、個性化的應用體驗。