设备唯一ID获取,支持安卓/iOS/鸿蒙Next(uni-device-id)UTS插件

news2025/2/25 4:20:19

设备唯一ID获取支持安卓/iOS/鸿蒙(uni-device-id)UTS插件

介绍

获取设备唯一ID、设备唯一标识，支持安卓（AndroidId/OAID/IMEI/MEID/MacAddress/Serial/UUID/设备基础信息）,iOS（Identifier/UUID），鸿蒙（AAID/ODID）。
iOS使用keychain持久存储UUID，应用卸载后UUID不变。
鸿蒙使用AssetMap存储UUID，应用卸载后UUID不变。

猛戳这里去插件市场看看

API说明

方法名称	参数	返回参数	说明
getUniqueDeviceId	无	string	安卓调用顺序OAID->AndroidId->MacAddress->Serial->UUID。 iOS上使用UUID，keychain存储。鸿蒙上使用UUID，AssetMap存储
getDeviceId	无	string	安卓返回AndroidId。 iOS返回identifier。鸿蒙返回ODID
getOAID	回调	无	安卓返回OAID。鸿蒙返回AAID。iOS不支持
getImeiOrMeid	boolean	string	仅支持安卓，安卓根据参数true返回IMEI否则MEID，安卓10以下可获取，不包括10，安卓6以上申请用户权限
getMacAddress	无	string	仅支持安卓，安卓11以下可用
getSerial	无	string	仅支持安卓，安卓10以下可用
generateUUID	无	string	无限制

插件试用

扫码下载

VUE代码调用示例


<script>

	import { getDeviceId,getOAID,getDeviceInfo,generateUUID,getImeiOrMeid,getSerial,getMacAddress,getUniqueDeviceId,isHarmonyOS4 } from "@/uni_modules/CZ-DeviceId";
	

	export default {
	
		data() {
			return {
				title:"DeviceId 示例"
			}
		},
		methods:{
			testGetUniqueDeviceId(){
				let id = getUniqueDeviceId();
				this.showToast(id);
			},
			testGetDeviceId(){
				let id = getDeviceId();
				this.showToast(id);
			},
			testGetOAID(){
				getOAID((value)=> this.showToast(value));
			},
			testGetImeiOrMeid(){
				getImeiOrMeid(true,(value)=> this.showToast(value));
				getImeiOrMeid(false,(value)=> this.showToast(value));
			},
			testGetSerial(){
				let sn = getSerial();
				this.showToast(sn);
			},
			testGetMacAddress(){
				let mac = getMacAddress();
				this.showToast(mac);
			},
			testGenerateUUID(){
				let uuid = generateUUID();
				this.showToast(uuid);
			},
			testGetDeviceInfo(){
				let json = getDeviceInfo();
				this.showToast(json);
			},
			showToast(msg){
				if(msg == ''){
					uni.showToast({
						icon:'none',
						title:'未获取到相关信息'
					})
				}else {
					uni.showToast({
						icon:'none',
						title: msg
					})
				}
			},
		}
		
	}
	
	
</script>

设备唯一标识说明：

AndroidId:

Android ID 是 Android 设备的唯一标识符，用于标识设备。
基本设备都能正常获取到，少部分设备无法获取；每个应用获取的AndroidID都不一致；单个应用卸载重装后AndroidID不变。
仅支持安卓。

OAID:

OAID 是 Android 系统提供的用于广告追踪的匿名标识符。
仅支持安卓。

IMEI/MEID:

IMEI/MEID国际移动设备身份码，用于唯一标识 GSM 和 UMTS 移动电话设备。
安卓10以前需要权限才能获取到，安卓10以后不支持，不包括安卓10。

MacAddress:

MacAddress是设备的网络接口卡上的物理地址，也就是用于唯一标识网络设备的地址。
安卓11以前可以获取到。安卓11以后不支持，包括安卓11。

Serial:

Serial是硬件厂商为每个设备分配的一个独特的标识符。
安卓10以前获取到，安卓10以后不支持，不包括安卓10。

UUID:

随机生成的设备ID。
每次获取都会重新生成。
支持安卓、iOS、鸿蒙。

Identifier:

Identifier是由苹果系统生成的唯一标识符，用于标识同一供应商（即同一开发者账户下的应用）在同一设备上运行。
仅支持iOS。

AAID:

鸿蒙应用匿名标识符，标识运行在移动智能终端设备上的应用实例，只有该应用实例才能访问该标识符，它只存在于应用的安装期，总长度32位。与无法重置的设备级硬件ID相比，AAID具有更好的隐私权属性。
AAID和已有的任何标识符都不关联，并且每个应用只能访问自己的AAID。
同一个设备上，同一个开发者的多个应用，AAID取值不同。
同一个设备上，不同开发者的应用，AAID取值不同。
不同设备上，同一个开发者的应用，AAID取值不同。
不同设备上，不同开发者的应用，AAID取值不同。
仅支持鸿蒙。

ODID:

开发者匿名设备标识符，它主要用于开放给开发者的设备标识，同一设备上运行的同一个开发者的应用，ODID相同。帮助开发者更好地理解用户在不同应用间的行为，从而提供更个性化的服务和推荐。
同一设备上运行的同一个开发者的应用，ODID相同。
同一个设备上不同开发者的应用，ODID不同。
不同设备上同一个开发者的应用，ODID不同。
不同设备上不同开发者的应用，ODID不同。
仅支持鸿蒙。

用到的权限

安卓

<!-- 读取手机信息 -->
	<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
	<!-- 读取WIFI信息 -->
	<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
	<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

iOS

无

鸿蒙

      {
        "name": "ohos.permission.STORE_PERSISTENT_DATA",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "always"
        },
      }