# Print output for @column tags ?> WalletCard.Builder - Android SDK | Android Developers

Most visited

Recently visited

WalletCard.Builder

public static final class WalletCard.Builder
extends Object

java.lang.Object
   ↳ android.service.quickaccesswallet.WalletCard.Builder


Builder for WalletCard objects. You must to provide cardId, cardImage, contentDescription, and pendingIntent. If the card is opaque and should be shown with elevation, set hasShadow to true. cardIcon and cardLabel are optional.

Summary

Public constructors

Builder(String cardId, Icon cardImage, CharSequence contentDescription, PendingIntent pendingIntent)

Public methods

WalletCard build()

Builds a new WalletCard instance.

WalletCard.Builder setCardIcon(Icon cardIcon)

An icon may be shown alongside the card image to convey information about how the card can be used, or if some other action must be taken before using the card.

WalletCard.Builder setCardLabel(CharSequence cardLabel)

A card label may be shown alongside the card image to convey information about how the card can be used, or if some other action must be taken before using the card.

Inherited methods

Public constructors

Builder

public Builder (String cardId, 
                Icon cardImage, 
                CharSequence contentDescription, 
                PendingIntent pendingIntent)

Parameters
cardId String: The card id must be non-null and unique within the list of cards returned. Note: this card ID should not contain PII (Personally Identifiable Information, such as username or email address). This value cannot be null.

cardImage Icon: The visual representation of the card. If the card image Icon is a bitmap, it should have a width of GetWalletCardsRequest.getCardWidthPx() and a height of GetWalletCardsRequest.getCardHeightPx(). If the card image does not have these dimensions, it may appear distorted when it is scaled to fit these dimensions on screen. Bitmaps must be of type Bitmap.Config.HARDWARE for performance reasons. This value cannot be null.

contentDescription CharSequence: The content description of the card image. This field is required and may not be null or empty. Note: this message should not contain PII (Personally Identifiable Information, such as username or email address). This value cannot be null.

pendingIntent PendingIntent: If the user performs a click on the card, this PendingIntent will be sent. If the device is locked, the wallet will first request device unlock before sending the pending intent. It is recommended that the pending intent be immutable (use PendingIntent.FLAG_IMMUTABLE). This value cannot be null.

Public methods

build

public WalletCard build ()

Builds a new WalletCard instance.

Returns
WalletCard A built response. This value cannot be null.

setCardIcon

public WalletCard.Builder setCardIcon (Icon cardIcon)

An icon may be shown alongside the card image to convey information about how the card can be used, or if some other action must be taken before using the card. For example, an NFC logo could indicate that the card is NFC-enabled and will be provided to an NFC terminal if the phone is held in close proximity to the NFC reader. This field is optional.

If the supplied Icon is backed by a bitmap, it should have width and height GetWalletCardsRequest#getIconSizePx().

Parameters
cardIcon Icon: This value may be null.

Returns
WalletCard.Builder This value cannot be null.

setCardLabel

public WalletCard.Builder setCardLabel (CharSequence cardLabel)

A card label may be shown alongside the card image to convey information about how the card can be used, or if some other action must be taken before using the card. For example, an NFC-enabled card could be labeled "Hold near reader" to inform the user of how to use NFC cards when interacting with an NFC reader. This field is optional. Note: this card label should not contain PII (Personally Identifiable Information, such as username or email address). If the provided label is too long to fit on one line, it may be truncated and ellipsized.

Parameters
cardLabel CharSequence: This value may be null.

Returns
WalletCard.Builder This value cannot be null.