Added in API level 28

Builder

class Builder
kotlin.Any
   ↳ android.telephony.SubscriptionPlan.Builder

Builder for a SubscriptionPlan.

Summary

Public methods
open SubscriptionPlan!

open static SubscriptionPlan.Builder!

Start defining a SubscriptionPlan that covers a very specific window of time, and never automatically recurs.
open static SubscriptionPlan.Builder!
createRecurring(start: ZonedDateTime!, period: Period!)

Start defining a SubscriptionPlan that starts at a specific time, and automatically recurs after each specific period of time, repeating indefinitely.
open SubscriptionPlan.Builder

Reset any network types that were set with setNetworkTypes(int[]).
open SubscriptionPlan.Builder!
setDataLimit(dataLimitBytes: Long, dataLimitBehavior: Int)

Set the usage threshold at which data access changes.
open SubscriptionPlan.Builder!
setDataUsage(dataUsageBytes: Long, dataUsageTime: Long)

Set a snapshot of currently known mobile data usage.
open SubscriptionPlan.Builder
setNetworkTypes(networkTypes: IntArray)

Set the network types this SubscriptionPlan applies to.
open SubscriptionPlan.Builder
setSubscriptionStatus(subscriptionStatus: Int)

Set the subscription status.
open SubscriptionPlan.Builder!

Sets a brief, human-readable summary of the subscription plan.
open SubscriptionPlan.Builder!

Sets a user-visible title for this plan.

Public methods

build

Added in API level 28
open fun build(): SubscriptionPlan!

createNonrecurring

Added in API level 28
open static fun createNonrecurring(
    start: ZonedDateTime!, 
    end: ZonedDateTime!
): SubscriptionPlan.Builder!

Start defining a SubscriptionPlan that covers a very specific window of time, and never automatically recurs.

Parameters
start ZonedDateTime!: The exact time at which the plan starts.
end ZonedDateTime!: The exact time at which the plan ends.

createRecurring

Added in API level 28
open static fun createRecurring(
    start: ZonedDateTime!, 
    period: Period!
): SubscriptionPlan.Builder!

Start defining a SubscriptionPlan that starts at a specific time, and automatically recurs after each specific period of time, repeating indefinitely.

When the given period is set to exactly one month, the plan will always recur on the day of the month defined by ZonedDateTime.getDayOfMonth(). When a particular month ends before this day, the plan will recur on the last possible instant of that month.

Parameters
start ZonedDateTime!: The exact time at which the plan starts.
period Period!: The period after which the plan automatically recurs.

resetNetworkTypes

Added in API level 30
open fun resetNetworkTypes(): SubscriptionPlan.Builder

Reset any network types that were set with setNetworkTypes(int[]). This will make the SubscriptionPlan apply to all network types.

Return
SubscriptionPlan.Builder This value cannot be null.

setDataLimit

Added in API level 28
open fun setDataLimit(
    dataLimitBytes: Long, 
    dataLimitBehavior: Int
): SubscriptionPlan.Builder!

Set the usage threshold at which data access changes.

Parameters
dataLimitBytes Long: the usage threshold at which data access changes.
Value is a non-negative number of bytes.
dataLimitBehavior Int: the behavior of data access when usage reaches the threshold.
Value is one of the following:

setDataUsage

Added in API level 28
open fun setDataUsage(
    dataUsageBytes: Long, 
    dataUsageTime: Long
): SubscriptionPlan.Builder!

Set a snapshot of currently known mobile data usage.

Parameters
dataUsageBytes Long: the currently known mobile data usage.
Value is a non-negative number of bytes.
dataUsageTime Long: the time at which this snapshot was valid.
Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.

setNetworkTypes

Added in API level 30
open fun setNetworkTypes(networkTypes: IntArray): SubscriptionPlan.Builder

Set the network types this SubscriptionPlan applies to. By default the plan will apply to all network types. An empty array means this plan applies to no network types.

Parameters
networkTypes IntArray: an array of all network types that apply to this plan.
This value cannot be null.
Value is one of the following:
Return
SubscriptionPlan.Builder This value cannot be null.

See Also

    setSubscriptionStatus

    Added in API level 36
    open fun setSubscriptionStatus(subscriptionStatus: Int): SubscriptionPlan.Builder

    Set the subscription status.

    This indicates the current state of the subscription, such as whether it is active, suspended, or in a trial period. This status provides context on the plan's availability and can be used to inform the user about their subscription's lifecycle.

    Parameters
    subscriptionStatus Int: the current subscription status.
    Value is one of the following:
    Return
    SubscriptionPlan.Builder This value cannot be null.

    setSummary

    Added in API level 28
    open fun setSummary(summary: CharSequence?): SubscriptionPlan.Builder!

    Sets a brief, human-readable summary of the subscription plan.

    This could include details about the plan's features, such as "10GB of high-speed data" or "Unlimited talk and text". This summary is intended for display to the user.

    Parameters
    summary CharSequence?: A short, user-friendly summary of the plan, or null to clear it.

    setTitle

    Added in API level 28
    open fun setTitle(title: CharSequence?): SubscriptionPlan.Builder!

    Sets a user-visible title for this plan.

    This title is provided by the carrier to identify the subscription plan, for example, "Unlimited+" or "Family plan". It is intended for display to the user.

    Parameters
    title CharSequence?: The title of the plan.
    This value may be null.
    Return
    SubscriptionPlan.Builder! The same Builder instance to continue building the plan.