目录

HmsInstanceId

Class Info

public class HmsInstanceId

本类提供了获取AAID以及接入推送服务所需Token的方法。

Public Method Summary

Qualifier and Type

Method Name and Description

HmsInstanceId

getInstance()

获取HmsInstanceId类实例。

NSString*

getAAID:(NSString *)

获取AAID字符串。

NSNumber*

getCreationTime:(NSNumber *)

获取AAID生成时间戳。

void

deleteAAID:()

删除本地已经生成的AAID和生成时间戳。

NSString*

getToken:(NSString *) apnsToken

获取接入推送服务所需的Token。

void

deleteToken:()

注销接入推送服务所需的Token。

NSString*

getToken:(NSString *) apnsToken subjectId:(NSString*) subjectId

多发送者场景下,目标应用为发送者申请接入推送服务所需的Token。

void

deleteToken:(NSString *) subjectId

多发送者场景下,目标应用为发送者注销Token的方法。

Public Methods

[h2]getInstance

Method

- (HmsInstanceId *)getInstance

获取HmsInstanceId类实例的方法。

Returns

Type

Description

HmsInstanceId

HmsInstanceId类实例。

[h2]getAAID

Method

- (NSString *)getAAID

获取AAID(应用匿名ID)的方法。

Returns

Type

Description

NSString*

AAID字符串。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
NSString *aaid = [[HmsInstanceId getInstance] getAAID];
“Swift”
import HmsPushSdk
let aaid = HmsInstanceId.getInstance().getAAID();

[h2]getCreationTime

Method

- (NSNumber *)getCreationTime

获取AAID(应用匿名ID)生成的时间戳。

Returns

Type

Description

NSNumber*

标准时间戳。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
NSNumber *createTime = [[HmsInstanceId getInstance] getCreationTime];
“Swift”
import HmsPushSdk
let createTimeStr=HmsInstanceId.getInstance().getCreationTime();

[h2]deleteAAID

Method

- (void)deleteAAID

删除本地已经生成的AAID。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
[[HmsInstanceId getInstance] deleteAAID];
“Swift”
import HmsPushSdk
HmsInstanceId.getInstance().deleteAAID();

[h2]getToken:(NSString *) apnsToken

Method

- (NSString *)getToken:(NSString *) apnsToken

获取接入推送服务所需的Token。如果本地没有生成AAID,调用本方法会自动生成AAID,Push服务端生成Token时依赖AAID。

Parameters

Name

Description

apnsToken

从APNs(苹果推送通知服务)获取的device token(设备Token),device token是iOS设备的唯一标识。

Returns

Type

Description

NSString*

接入推送服务所需的Token。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
NSString *apnsToken = @"yourApnsToken";
NSString *huaweiToken = [[HmsInstanceId getInstance] getToken:apnsToken];
“Swift”
import HmsPushSdk
let apnsToken = "yourApnsToken";
let huaweiToken = HmsInstanceId.getInstance().getToken(apnsToken);

[h2]deleteToken

Method

- (void)deleteToken

注销接入推送服务所需的Token。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
[[HmsInstanceId getInstance] deleteToken];
“Swift”
import HmsPushSdk
HmsInstanceId.getInstance().deleteToken();

[h2]getToken:(NSString* apnsToken, NSString* subjectId)

Method

- (NSString *)getToken:(NSString *) apnsToken

subjectId:(NSString*) subjectId;

在多发送者场景下,目标应用给发送者申请Token的方法,subjectId需要传入AppGallery Connect中发送者的项目ID。

Parameters

Name

Description

apnsToken

从APNs(苹果推送通知服务)获取的device token(设备Token),device token是iOS设备的唯一标识。

subjectId

发送者的项目ID,登录AppGallery Connect网站,选择“我的项目”,在项目列表中选择对应的项目,左侧导航栏选择“项目设置”,在该页面获取发送者的项目ID。

Returns

Type

Description

NSString*

接入推送服务所需的Token。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
NSString *apnsToken = @"yourApnsToken";
NSString *projectId = @"yourProjectId";
NSString *huaweiToken = [[HmsInstanceId getInstance] getToken:apnsToken subjectId:projectId];
“Swift”
import HmsPushSdk
let projectID = "yourProjectId";
let apnsToken = "yourApnsToken";
let hwTokenSubProjectId = HmsInstanceId.getInstance().getToken(apnsToken,subjectId: projectID);

[h2]deleteToken:(NSString *) subjectId

Method

- (void)deleteToken:(NSString *) subjectId

在多发送者场景下,目标应用给发送者注销Token方法,subjectId需要传入AppGallery Connect中发送者的项目ID。

Parameters

Name

Description

subjectId

发送者的项目ID,登录AppGallery Connect网站,选择“我的项目”,在项目列表中选择对应的项目,左侧导航栏选择“项目设置”,在该页面获取发送者的项目ID。

“Objective-C”
#import <HmsPushSdk/HmsInstanceId.h>
NSString* projectId = @"yourProjectId";
[[HmsInstanceId getInstance] deleteToken:projectId];
“Swift”
import HmsPushSdk
let projectID = "yourProjectId";
HmsInstanceId.getInstance().deleteToken(projectID);