概述
PassObject loyaltyObject = PassObject.getBuilder().setSerialNumber("12345") .addImageList(new ArrayList<>()) //... 其他设置由您根据情况自己选择添加 .build();
LabelValue信息在HMS中,被合并到textData中。
To HMS API转换参考如下代码,将LabelValueRow对象中的LabelValue列表转换为HMS中的AppendField列表,LabelValue中的label和value属性,分别赋值给AppendField中的label和value属性,最后调用PassObject对象的addTextList()方法,将AppendField对象列表赋予PassObject对象:
// 下面的row1/row2对应LabelValueRow中LabelValueLie表中的对象
AppendField row1= AppendField.getBuilder().setKey("uniqueKey1") // 此处key值可以随意指定,但必须保证在一个对象中是唯一的
.setLabel("Next Reward") // label值对应LabelValue中的label
.setValue("2 coffees") // value值对应LabelValue中的value
.build();
AppendField row2= AppendField.getBuilder().setKey("uniqueKey2")
.setLabel("Member Since")
.setValue("01/15/2013")
.build();
ArrayList<AppendField> textList = new java.util.ArrayList<>();
textList.add(row1);
textList.add(row2);
PassObject.getBuilder().addTextList(textList); To HMS API中,此方法转换请参见addInfoModuleDataLabeValueRow(LabelValueRow row)。
To HMS API替换如下:
参数类型为UriData的两个属性uri与description分别与HMS中AppendField的属性value和label一一对应。把参数uriData转换成类型为AppendField的image,key值用户可以自已指定,但不能重复。构建一个ArrayList<AppendField> imageList,把image放入imageList中,最后通过PassObject的addImageList()方法把imageList赋给PassObject对象。
UriData uriData = new UriData("www.huaweitest.com", "huawei net");// 此处new仅供示例用,实际代码中要取对应的UriData对象 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<AppendField> imageList = new ArrayList<>(); AppendField.Builder image = AppendField.getBuilder(); AppendField imageField = image.setKey("image" + image.hashCode()) .setValue(uriData.getUri()) .setLabel(uriData.getDescription()) .build(); imageList.add(imageField); passBuilder.addImageList(imageList);
To HMS API替换具体操作请参见addImageModuleDataMainImageUri(UriData uriData)。
Add HMS API和To HMS API请统一按如下指导转换。
会员卡、礼品卡、优惠券转换方法均相同,以会员卡为例说明:
将LoyaltyWalletObject中的:
public LoyaltyWalletObject.Builder addLinksModuleDataUri(UriData uriData);
按以下指导:
参数uriData 属性uri值类型目前可分为Nearby stores、Main page、Hotline三种类型,构建HMS中AppendField对象时,对应HMS的key值常量为:
WalletPassConstant.PASS_APPEND_FIELD_KEY_NEARBY_LOCATIONS,
WalletPassConstant.PASS_APPEND_FIELD_KEY_MAINPAGE,
WalletPassConstant.PASS_APPEND_FIELD_KEY_HOTLINE。
HMS中的AppendField对象的value可取参数uriData的uri值,Label值可取uriData的description值。
构建一个类型为AppendField对象实例hotlineAppendField,放入List<AppendField> appendFields中,最后通过PassObject的addAppendFields()方法将appendFields赋给PassObject对象。
Hotline示例代码:
PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<AppendField> appendFields = new ArrayList<>(); String hotlineLabel = "hotline"; String hotlineValue = "4000"; AppendField hotlineAppendField = AppendField.getBuilder() .setKey(WalletPassConstant.PASS_APPEND_FIELD_KEY_HOTLINE) .setLabel(hotlineLabel) .setValue(hotlineValue) .build(); appendFields.add(hotlineAppendField); passBuilder.addAppendFields(appendFields);
Add HMS API和To HMS API转换请参见addLinksModuleDataUri(UriData uriData)。
To HMS API替换如下:
参数类型为LatLng的两个属性longitude与latitude分别与HMS中Location的属性longitude和latitude一一对应。把参数latLng转换成类型为Location的location。构建一个ArrayList<Location> locations,把location放入locations 中,最后通过PassObject对象的addLocationList()方法将locations值赋给PassObject对象。
LatLng latLng = new LatLng(22.545167,114.056641);// 此处new仅供示例用,实际代码中要取对应的LatLng对象 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<Location> locations = new ArrayList<>(); Location location = new Location(String.valueOf(latLng.getLongitude()), String.valueOf(latLng.getLatitude())); locations.add(location); passBuilder.addLocationList(locations);
To HMS API替换如下:
参数类型为WalletObjectMessage的两个属性body和header分别与HMS中AppendField的属性value和label一一对应。把参数walletObjectMessage转换成类型为AppendField的field,key值用户可以自已指定,但不能重复。构建一个ArrayList<AppendField> messageList,把field放入messageList中,最后通过PassObject对象的addMessageList()方法将messageList值赋给PassObject对象。
WalletObjectMessage walletObjectMessage = WalletObjectMessage.newBuilder()
.setHeader("Hi Jane!")
.setBody("Thanks for saving your gift card.")
.build();
PassObject.Builder passBuilder = PassObject.getBuilder();
ArrayList<AppendField> messageList = new java.util.ArrayList<>();
AppendField.Builder message = AppendField.getBuilder();
AppendField field = message.setKey("message" + message.hashCode())
.setValue(walletObjectMessage.getBody())
.setLabel(walletObjectMessage.getHeader())
.build();
messageList.add(field);
passBuilder.addMessageList(messageList); To HMS API替换请参见addMessage(WalletObjectMessage walletObjectMessage)。
To HMS API替换如下:
参数类型为TextModuleData的两个属性body和header分别与HMS中AppendField的属性value和label一一对应。把参数textModuleData转换成类型为AppendField的textData,key值用户可以自已指定,但不能重复。构建一个ArrayList<AppendField> textDataList,把textData放入textDataList中,最后通过PassObject的addTextList()方法把textDataList赋给PassObject对象。
TextModuleData textModuleData =new TextModuleData("Header", "Use your gift card when you purchase your next bacon fat latte!"); PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<AppendField> textDataList = new java.util.ArrayList<>(); AppendField.Builder textDataBuilder = AppendField.getBuilder(); AppendField textData = textDataBuilder.setKey("text" + textDataBuilder.hashCode()) .setValue(textModuleData.getBody()) .setLabel(textModuleData.getHeader()) .build(); textDataList.add(textData); passBuilder.addTextList(textDataList);
To HMS API替换请参见addTextModuleData(TextModuleData textModuleData)。
调用build创建Request之前,需要执行以下步骤:
if (org.xms.g.utils.GlobalEnvSetting.isHms()) {
String passObjectJson = ((com.huawei.hms.wallet
.pass
.PassObject) (wob.getHInstance())).toJson();
String jweString = getJweFromAppServer(passObjectJson);
((com.huawei.hms.wallet.CreateWalletPassRequest.Builder) (build.getHInstance())).setContent(jweString);
}
//wob是PassObject的对象实例。
//build是CreateWalletPassRequest的对象实例。 To HMS API
调用build创建Request之前,需要执行以下步骤:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 String passObjectJson = passObject.toJson(); String jweString = getJweFromAppServer(passObjectJson); CreateWalletPassRequest.Builder builder = CreateWalletPassRequest.getBuilder(); builder.setContent(jweString);
您在创建GiftCardWalletObject之前,需要手动设置PassTypeIdentifier。PassTypeIdentifier的值为用户在AppGallery网站上注册WalletKit卡券服务时的服务号,示例代码中GiftCardWalletObject、LoyaltyWalletObject、OfferWalletObject的PassTypeIdentifier的值分别是:“hwpass.type.giftcard.hmspublic”,“hwpass.type.loyalty.hmspublic”和“hwpass.type.offer.hmspublic”。
((com.huawei.hms.wallet.pass.PassObject.Builder) wob.getHInstance()).setPassTypeIdentifier("hwpass.type.offer.hmspublic"); 注释:wob是PassObject对象的实例。
PassObject.Builder passBuilder = PassObject.getBuilder(); passBuilder.setPassTypeIdentifier("hwpass.type.offer.hmspublic");
Add HMS API和To HMS API均按如下方式转换:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 BarCode barCode = passObject.getBarCode(); String text = barCode.getText();
Add HMS API和To HMS API均按如下方式转换:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 BarCode barCode = passObject.getBarCode(); String text = barCode.getType();
Add HMS API和To HMS API均按如下方式转换:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 BarCode barCode = passObject.getBarCode(); String text = barCode.getValue();
在HMS中LabelValue对象需要转换成AppendField对象使用。
Add HMS API和To HMS API均参见如下方式转换:
AppendField field = AppendField.getBuilder().setKey("key") // 说明,Key值可以随意填写,但是需要保证在同一个PassObject中不能重复 .setLabel("LabelValue.getLabel()") .setValue("LabelValue.getValue()") .build();
LabelValueRow类可参考此类和addInfoModuleDataLabeValueRow(LabelValueRow row)。
在HMS中,会员卡积分只支持值和标签的设置,值为String类型,不区分货币类型。可以参见setLoyaltyPoints(LoyaltyPoints loyaltyPoints)。
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_CARD_NUMBER(值为“cardNumber”),value值为accountId。构建一个ArrayList<CommonField> idList,把field加入idList。最后通过PassObject对象的addCommonFields()方法将idList值赋给PassObject对象,同时把accountId赋值给PassObject的organizationPassId属性。
String accountId = "123";//说明,accountId值由您传入 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> idList = new ArrayList<>(); CommonField field = CommonField.getBuilder().setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_CARD_NUMBER) .setValue(accountId) .build(); idList.add(field); passBuilder.addCommonFields(idList) .setOrganizationPassId(accountId); // accoutId同时需要赋值给passId
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_MEMBER_NAME(值为“memberName”),value值为accountName。构建一个ArrayList<CommonField> accountNameList,把field加入accountNameList。最后通过PassObject对象的addCommonFields()方法将accountNameList值赋给PassObject对象。
String accountName = "Jane"; //说明,accountName值由您传入 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> accountNameList = new ArrayList<>(); CommonField field = CommonField.getBuilder().setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_MEMBER_NAME) .setValue(accountName) .build(); accountNameList.add(field); passBuilder.addCommonFields(accountNameList);
To HMS API替换如下:
构建一个CommonField对象balance,key值为PASS_COMMON_FIELD_KEY_BALANCE(值为“balance”),value值为balanceMicros值。 构建一个ArrayList<CommonField> balanceMicrosList ,把balance加入balanceMicrosList。最后通过PassObject对象的addCommonFields()方法将balanceMicrosList值赋给PassObject对象。
long balanceMicros = 1;//说明,balance值由您传入 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> balanceMicrosList = new ArrayList<>(); CommonField balance = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_BALANCE) .setValue(String.valueOf(balanceMicros)) .build(); balanceMicrosList.add(balance); passBuilder.addCommonFields(balanceMicrosList);
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_BALANCE_REFRESH_TIME(值为“balanceRefreshTime”),value值为balanceUpdateTime。构建一个ArrayList<CommonField> balanceUpdateTimeList,把field加入balanceUpdateTimeList。最后通过PassObject对象的addCommonFields()方法将balanceUpdateTimeList值赋给PassObject对象。
long balanceUpdateTime = 160509291;//说明,balanceRefreshTime值由您传入(例如:2020-11-11 11:08:35) PassObject.Builder passBuilder = PassObject.getBuilder(); SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); String time = format.format(new Date(balanceUpdateTime)); ArrayList<CommonField> balanceUpdateTimeList = new ArrayList<>(); CommonField field = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_BALANCE_REFRESH_TIME) .setValue(time) .build(); balanceUpdateTimeList.add(field); passBuilder.addCommonFields(balanceUpdateTimeList);
使用HMS Wallet方案时,二维码相关信息要一次性全部设置完成,BarCode的Type分别是BarCode.BARCODE_TYPE_QR_CODE(二维码)和BarCode.BARCODE_TYPE_CODABAR(条形码)。
Add HMS API和To HMS API替换如下:
PassObject.Builder passObject= PassObject.getBuilder();
BarCode barCode = BarCode.getBuilder().setType(BarCode.BARCODE_TYPE_QR_CODE).setText("12345").setValue("28343E3").build();
passObject.setBarCode(barCode); 只有礼品卡做转换。
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_CARD_NUMBER(值为“cardNumber”),value值为cardNumber。构建一个ArrayList<CommonField> cardNumberList,把field加入cardNumberList。最后通过PassObject对象的addCommonFields()方法将cardNumberList值赋给PassObject对象,同时通过setOrganizationPassId方法将cardNumber赋给PassObject对象。
String cardNumber = "abc123";//说明,礼品卡的卡号cardNumber值由您自己输入 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> cardNumberList = new ArrayList<>(); CommonField field = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_CARD_NUMBER) .setValue(cardNumber) .build(); cardNumberList.add(field); passBuilder.addCommonFields(cardNumberList).setOrganizationPassId(cardNumber); // 礼品卡的卡号同时作为参数赋值给passId,在HMS中必须设置passId
To HMS API替换如下:
构建一个AppendField对象field,key值为PASS_APPEND_FIELD_KEY_EVENT_NUMBER(值为"eventNumber"),value值为eventNumber值。构建一个ArrayList<AppendField> eventNumberList,把field 加入eventNumberList。最后通过PassObject对象的addAppendFields()方法将eventNumberList值赋给PassObject对象。
String eventNumber = "eventNumber1";//说明,eventNumber值由您自己输入 ArrayList<AppendField> eventNumberList = new ArrayList<>(); AppendField field = AppendField.getBuilder() .setKey(WalletPassConstant.PASS_APPEND_FIELD_KEY_EVENT_NUMBER) .setValue(eventNumber) .build(); eventNumberList.add(field); PassObject.Builder passBuilder = PassObject.getBuilder(); passBuilder.addAppendFields(eventNumberList);
在HMS中,每个卡券均新增了一个passId字段,是个必填字段。在优惠券设置Id时,passId与id值相同,需要一同设置。
To HMS API转换如下(优惠券):
String id = "abc123";//说明,id由您自己输入 PassObject.getBuilder().setSerialNumber(id).setOrganizationPassId(id);
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_MERCHANT_NAME(值为“merchantName”),value值为merchantName。构建一个ArrayList<CommonField> issuerNameList,把field 加入issuerNameList。最后通过PassObject对象的addCommonFields()方法将issuerNameList值赋给PassObject对象。
String merchantName = "merchantName";//说明,merchantName值由您自己设置 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> issuerNameList = new ArrayList<>(); CommonField field = CommonField.getBuilder().setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_MERCHANT_NAME) .setValue(merchantName) .build(); issuerNameList.add(field); passBuilder.addCommonFields(issuerNameList);
To HMS API替换如下:
构建一个AppendField对象balance,key值为PASS_APPEND_FIELD_KEY_POINTS(值为“points”),value和label值为loyaltyPoints对象中属性loyaltyPointsBalance的对象value值和label值。 构建一个ArrayList<AppendField> balanceList ,把balance 加入balanceList。最后通过PassObject对象的addAppendFields()方法将balanceList 值赋给PassObject对象。如果积分类型为货币时,还需要通过PassObject.Builder的setCurrencyCode()方法设置货币类型。
LoyaltyPoints loyaltyPoints = LoyaltyPoints.newBuilder().build(); // 此处new仅供示例用,实际代码中要取对应的LoyaltyPoints对象 PassObject.Builder passBuilder = PassObject.getBuilder(); LoyaltyPointsBalance gBalance = loyaltyPoints.getBalance(); int balanceType = gBalance.getType(); String value = ""; if (balanceType == LoyaltyPointsBalance.Type.getDOUBLE()) { value = String.valueOf(gBalance.getDouble()); } else if (balanceType == LoyaltyPointsBalance.Type.getINT()) { value = String.valueOf(gBalance.getInt()); } else if (balanceType == LoyaltyPointsBalance.Type.getSTRING()) { value = gBalance.getString(); } else if (balanceType == LoyaltyPointsBalance.Type.getMONEY()) { value = String.valueOf(gBalance.getCurrencyMicros()); passBuilder.setCurrencyCode(gBalance.getCurrencyCode()); } ArrayList<AppendField> balanceList = new ArrayList<>(); AppendField balance = AppendField.getBuilder().setKey(WalletPassConstant.PASS_APPEND_FIELD_KEY_POINTS) .setValue(value) .setLabel(loyaltyPoints.getLabel()) .build(); balanceList.add(balance); passBuilder.addAppendFields(balanceList);
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_BLANCE_PIN(值为“pin”),value值为pin。构建一个ArrayList<CommonField> pinList,把field加入pinList。最后通过PassObject对象的addCommonFields()方法将pinList值赋给PassObject对象。
String pin = "pinValue"; //说明,pin值由您自己设置 ArrayList<CommonField> pinList = new ArrayList<>(); CommonField field = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_BLANCE_PIN) .setValue(pin) .build(); pinList.add(field); PassObject.Builder passBuilder = PassObject.getBuilder(); passBuilder.addCommonFields(pinList);
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_NAME(值为“name”),value值为programName。构建一个ArrayList<CommonField> issuerNameList,把field 加入programNameList。最后通过PassObject对象的addCommonFields()方法将programNameList值赋给PassObject对象。
String programName = "programName"; //说明,programName的值由您自己设置 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> programNameList = new ArrayList<>(); CommonField field = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_NAME) .setValue(programName) .build(); programNameList.add(field); passBuilder.addCommonFields(programNameList);
在HMS中,卡片的状态和有效时间共同组成PassStatus对象。
Add HMS API和To HMS API替换如下:
构建PassObject对象,为其属性status赋值。PassObject的属性status的数据类型为PassStatus对象,PassStatus对象的属性state的值根据实际情况设置,具体状态为"active","completed","expired","inactive"。
示例:
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); Long startTime = 0L; Long endTime = 0L; PassStatus passStatus = PassStatus.getBuilder() .setState("active") .setEffectTime(format.format(new Date(startTime))) .setExpireTime(format.format(new Date(endTime))) .build(); PassObject.Builder passBuilder = PassObject.getBuilder(); passBuilder.setStatus(passStatus);
注释:startTime和endTime是时间的毫秒值,可根据卡券的实际的时间的毫秒值填写。
To HMS API替换如下:
构建一个CommonField对象field,key值为PASS_COMMON_FIELD_KEY_NAME(值为“name”),value值为title。构建一个ArrayList<CommonField> titleList,把field 加入titleList 。最后通过PassObject对象的addCommonFields()方法将titleList值赋给PassObject对象。
String title = "title";// 说明,title值由您自己设置 PassObject.Builder passBuilder = PassObject.getBuilder(); ArrayList<CommonField> titleList = new ArrayList<>(); CommonField field = CommonField.getBuilder() .setKey(WalletPassConstant.PASS_COMMON_FIELD_KEY_NAME) .setValue(title) .build(); titleList.add(field); passBuilder.addCommonFields(titleList);
Add HMS API和To HMS API替换如下:
TimeInterval的属性startTimestamp和endTimestamp分别对应HMS的PassStatus对象属性effectTime和expireTime,具体构建请参见setState(int state)。
在HMS中TextModuleData对象需要转换成AppendField对象使用。
Add HMS API和To HMS API均参见如下方式转换:
AppendField field = AppendField.getBuilder().setKey("key") // 说明,Key值可以随意填写,但是需要保证在同一个PassObject中不能重复 .setLabel("TextModuleData.getHeader()") .setValue("TextModuleData.getBody()") .build();
在HMS中UriData对象需要转换成AppendField对象使用。
Add HMS API和To HMS API均参见如下方式转换:
AppendField field = AppendField.getBuilder().setKey("key") // 说明,Key值可以随意填写,但是需要保证在同一个PassObject中不能重复 .setLabel("UriData.getDescription()") .setValue("UriData.getUri()") .build();
在HMS中WalletObjectMessage对象需要转换成AppendField对象使用。
Add HMS API和To HMS API均参见如下方式转换:
AppendField field = AppendField.getBuilder().setKey("key") // 说明,Key值可以随意填写,但是需要保证在同一个PassObject中不能重复 .setLabel("WalletObjectMessage.getHeader()") .setValue("WalletObjectMessage.getBody()") .build();
To HMS API中,在HMS中使用如下方法替代:
public static WalletPassClient getWalletPassClient(Activity activity); 在HMS中,卡券状态通过字符串常量来标志,常量定义在com.huawei.hms.wallet.constant.WalletPassConstant类中:
public static final String PASS_STATE_COMPLETED = "completed"; public static final String PASS_STATE_EXPIRED = "expired"; public static final String PASS_STATE_INACTIVE = "inactive"; public static final String PASS_STATE_ACTIVE = "active";
可以参见setState(int state)。
List<com.google.android.gms.wallet.wobs.UriData> getImageModuleDataMainImageUris()
在HMS中,没有类可以完全对应UriData,UriData可以被HMS中的AppendField类替代。
To HMS API中,以上接口可以通过如下代码替代:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 List<AppendField> imageList = passObject.getImageList();
返回值不一样,AppendField中的属性值与UriData的属性值的对应关系,请参见addImageModuleDataMainImageUri(UriData uriData)。
类似的,以下接口也是一样的替换方式:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 List<AppendField> messageList = passObject.getMessageList();
AppendField中的属性值与WalletObjectMessage的属性值的对应关系,请参见addMessage(WalletObjectMessage walletObjectMessage)。
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 List<AppendField> messageList = passObject.getTextList();
AppendField中的属性值与TextModuleData的属性值的对应关系,请参见addTextModuleData(TextModuleData textModuleData)。
在HMS中,没有对应的get方法,如果需要获取issuerName,可以参见如下代码修改,通过指定key值从PassObject的CommonFIelds中获取属性值。
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象
String issuerName;
List<CommonField> fields = passObject.getCommonField();
for (CommonField field : fields) {
if (WalletPassConstant.PASS_COMMON_FIELD_KEY_MERCHANT_NAME.equals(field.getKey())) {
issuerName = field.getValue(); // 获取到issuerName属性值
break;
}
} 类似的,如下获取属性值的接口也可以使用上述代码进行替换,只需使用对应的key值即可。
接口 | key值 |
|---|---|
getAccountId() | |
getAccountName() | |
getBalanceMicros() | |
getBalanceUpdateTime() | WalletPassConstant.PASS_COMMON_FIELD_KEY_BALANCE_REFRESH_TIME |
getCardNumber() | |
getPin() | |
getProgramName() | |
getTitle() |
另外,以下两个接口,也可以用上述类似方法获取属性值,只是其key值是在AppendField中。
接口 | key值 |
|---|---|
getEventNumber() | |
getLoyaltyPoints() |
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象
String eventNumber;
List<AppendField> fields = passObject.getAppendFields(); // 对比上面的例子,这里需要调用getAppendFields()方法
for (AppendField field : fields) {
if (WalletPassConstant.PASS_APPEND_FIELD_KEY_EVENT_NUMBER.equals(field.getKey())) {
eventNumber= field.getValue(); // 获取到eventNumber属性值
break;
}
}
List<com.google.android.gms.maps.model.LatLng> getLocations()
To HMS API中,使用如下代码获取HMS中的对应信息:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 List<Location> locationList = passObject.getLocationList();
返回值为Location列表,其中Location为Wallet Kit自定义的对象,您使用此方法需自行对返回值使用的地方做适配。
在HMS中,礼品卡没有设置单独的兑换码字段,其值已转换为条形码/二维码的码值,请参见java.lang.String getBarcodeType()获取兑换码。
在HMS中,卡片的状态和有效时间共同组成PassStatus对象,所以没有单独的接口获取卡片状态属性,您可以通过以下方式获取卡片的状态和有效期。
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 PassStatus passStatus = passObject.getStatus(); String state = passStatus.getState(); // 字符串表示的卡片状态 String effectiveTime = passStatus.getEffectTime(); // 卡券生效时间 String expireTime = passStatus.getExpireTime(); // 卡券过期时间
可以参见setState(int state)接口的说明。
HMS中没有类与LoyaltyPointsBalance对应,而且HMS中的会员卡积分不区分数据类型,均按字符串形式存储。所以您如果需要在HMS中使用此类,按以下方式替换。
Add HMS API和To HMS API均需要按如下方式使用:
设置积分的方法:
public final com.google.android.gms.wallet.wobs.LoyaltyPointsBalance.Builder setInt(int) public final com.google.android.gms.wallet.wobs.LoyaltyPointsBalance.Builder setDouble(double) public final com.google.android.gms.wallet.wobs.LoyaltyPointsBalance.Builder setString(java.lang.String) public final com.google.android.gms.wallet.wobs.LoyaltyPointsBalance.Builder setMoney(java.lang.String,long)
以上四个设置积分的方法均参见如下方法进行修改:
String label = "Points"; String value = "123"; String currencyCode = "12";//此处仅供示例用,实际开发中要根据需求获取对应的数据 PassObject.Builder passBuilder = PassObject.getBuilder(); List<AppendField> fields = new ArrayList<>(); AppendField balance = AppendField.getBuilder() .setKey(WalletPassConstant.PASS_APPEND_FIELD_KEY_POINTS) .setValue(value) // value为字符串形式的积分值 .setLabel(label) // label为标签字符串,同LoyaltyPointsBalance中的label .build(); fields.add(balance); passBuilder.addAppendFields(fields); // 如果积分为货币,需要设置货币码时,可以按如下方式设置 passBuilder.setCurrencyCode(currencyCode);
获取积分值的方法:
public final long getCurrencyMicros() public final double getDouble() public final int getInt() public final java.lang.String getString()
以上4个获取积分值的方法均参见如下方法进行修改,并且都是返回字符串形式的积分:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象
String loyaltyPoints;
List<AppendField> appendFields = passObject.getAppendFields();
for (AppendField field : appendFields) {
if (WalletPassConstant.PASS_APPEND_FIELD_KEY_POINTS.equals(field.getKey())) {
loyaltyPoints = field.getValue(); // 此处获取字符串类型的积分
break;
}
} 获取货比码的方法:
public final java.lang.String getCurrencyCode()
以上获取货比码的方法,直接使用PassObject的getCurrencyCode()方法即可:
PassObject passObject = new PassObject(); // 此处new仅供示例用,实际代码中要取对应的卡券PassObject对象 String currencyCode = passObject.getCurrencyCode();