A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Implementar planos de dados
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Android 9 permite que as operadoras forneçam diretamente detalhes
autorizados do plano aos usuários no app Configurações para reduzir a confusão do usuário e as chamadas
de suporte. Em dispositivos com Android 4.0 e versões mais recentes, os usuários podem configurar manualmente
os detalhes do plano de dados específico da operadora no app Configurações, por
exemplo, definindo avisos e limites para gerenciar o uso de dados.
Configuração por operadora
Para configurar planos de dados, as operadoras podem adicionar funcionalidades aos apps
Android existentes usando as
APIs SubscriptionPlan.
As APIs foram projetadas para oferecer suporte a uma ampla variedade de tipos de planos de dados, incluindo
recorrentes e não recorrentes, e planos que mudam com o tempo.
Confira um exemplo de como configurar um tipo comum de plano de dados recorrente:
SubscriptionManager sm =
context.getSystemService(SubscriptionManager.class);
sm.setSubscriptionPlans(subId, Lists.newArrayList(
SubscriptionPlan.Builder.createRecurringMonthly(
ZonedDateTime.parse("2016-12-03T10:00:00Z"))
.setTitle("G-Mobile")
.setDataLimit(4_000_000_000L,
SubscriptionPlan.LIMIT_BEHAVIOR_BILLED)
.setDataUsage(200_493_293L, dataUsageTimestamp)
.build()));
O dispositivo só permite que um app configure planos de dados em uma das seguintes condições:
As duas primeiras condições permitem que o app da operadora seja instalado pelo usuário,
sem precisar ser pré-instalado na imagem do sistema na fábrica.
O SO exige (e o CDD exige) que todos os detalhes do plano de dados configurados sejam
protegidos e disponibilizados apenas para o app da operadora que
originalmente forneceu os detalhes ao SO.
Um design sugerido é que um app de operadora use um serviço de manutenção ocioso para
atualizar os detalhes do plano de dados diariamente, mas as operadoras podem usar uma ampla
gama de mecanismos, como receber detalhes do plano de dados por mensagens SMS
internas da operadora. Os serviços de manutenção ociosa são melhor implementados com um
job JobScheduler que usa
setRequiresDeviceIdle()
e
setRequiresCharging().
Uso por SO
O SO usa os detalhes do plano de dados fornecidos pelas APIs SubscriptionPlan da seguinte
maneira:
- Os detalhes do plano são exibidos pelo app Configurações para mostrar o uso de dados
exato aos usuários e fornecer
links diretos para o app da operadora
para oportunidades de upgrade/upsell.
- Os limites de aviso e notificação de limite de uso de dados são configurados automaticamente
com base nos detalhes do plano. O aviso é definido como 90% do
limite.
- Se a operadora indicar temporariamente que a rede está
"congestionada",
o SO vai atrasar os trabalhos do JobScheduler que podem ser transferidos no tempo, reduzindo a carga
na rede da operadora.
- Se a operadora indicar temporariamente que a rede é
"ilimitada",
o SO poderá informar a conexão celular como "ilimitada" até que a operadora
limpe a substituição ou até que o valor de tempo limite (se fornecido) seja atingido.
- Ao comparar o uso de dados atual do usuário com o limite geral de dados, o
SO estima o uso normal de dados do usuário no final do ciclo de faturamento
e aloca de forma conservadora 10% de qualquer dado excedente para melhorar a experiência
do usuário, por exemplo, permitindo que os apps usem dados de vários caminhos.
Personalização e validação
O app Configurações do Android mostra todos os detalhes do plano de dados configurado pela operadora,
garantindo que os usuários vejam o status mais preciso do relacionamento com a operadora
e oferecendo um caminho para o app da operadora para atualizar o plano. Os fabricantes
de dispositivos que escolherem personalizar o app Configurações são recomendados a continuar
exibindo esses detalhes.
As APIs SubscriptionManager descritas nesta página são testadas pelo
android.telephony.cts.SubscriptionManagerTest, que garante que os detalhes do plano de dados
possam ser configurados por apps de operadoras e que as mudanças sejam propagadas no
SO.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-26 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[],[],null,["# Implement data plans\n\nAndroid 9 lets carriers directly provide authoritative\nplan details to users in the Settings app to reduce user confusion and support\ncalls. On devices running Android 4.0 and higher, users are able to manually\nconfigure their carrier-specific data plan details in the Settings app, for\nexample, setting warnings and limits to manage their data usage.\n\nConfiguration by carrier\n------------------------\n\nTo configure data plans, carriers can add functionality to their existing\nAndroid apps using the\n[`SubscriptionPlan` APIs](https://developer.android.com/reference/android/telephony/SubscriptionPlan.Builder).\nThe APIs are designed to support a wide range of data plan types, including both\nrecurring and non-recurring plans, and plans that change over time.\n\nHere's an example of how to configure a common type of data plan that recurs\nmonthly: \n\n SubscriptionManager sm =\n context.getSystemService(SubscriptionManager.class);\n sm.setSubscriptionPlans(subId, Lists.newArrayList(\n SubscriptionPlan.Builder.createRecurringMonthly(\n ZonedDateTime.parse(\"2016-12-03T10:00:00Z\"))\n .setTitle(\"G-Mobile\")\n .setDataLimit(4_000_000_000L,\n SubscriptionPlan.LIMIT_BEHAVIOR_BILLED)\n .setDataUsage(200_493_293L, dataUsageTimestamp)\n .build()));\n\nThe device only lets an app configure data plans under one of these conditions:\n\n- The SIM card has explicitly defined an app that can manage it, as defined by [`SubscriptionManager.canManageSubscription()`](https://developer.android.com/reference/android/telephony/SubscriptionManager.html#canManageSubscription(android.telephony.SubscriptionInfo)).\n- The carrier has pushed the [`KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING) value via `CarrierConfigManager` to indicate which app can manage the carrier's data plans.\n- The device has an app built into the system image that has the `MANAGE_SUBSCRIPTION_PLANS` permission.\n\nThe first two conditions enable the carrier app to be installed by the user,\nwithout requiring that it be pre-installed into the system image at the factory.\nThe OS enforces (and the CDD requires) that all configured data plan details are\nprotected and are only made available to the carrier app that originally\nprovided the details to the OS.\n\nOne suggested design is for a carrier app to use an idle maintenance service to\nupdate data plan details on a daily basis, but carriers are free to use a wide\nrange of mechanisms, such as receiving data plan details through carrier-internal\nSMS messages. Idle maintenance services are best implemented with a\n`JobScheduler` job that uses\n[`setRequiresDeviceIdle()`](https://developer.android.com/reference/android/app/job/JobInfo.Builder#setRequiresDeviceIdle(boolean))\nand\n[`setRequiresCharging()`](https://developer.android.com/reference/android/app/job/JobInfo.Builder.html#setRequiresCharging(boolean)).\n\nUsage by OS\n-----------\n\nThe OS uses the data plan details provided by the SubscriptionPlan APIs in the\nfollowing ways:\n\n- The plan details are surfaced via the Settings app to display accurate data usage to users and to provide [direct deep links into the carrier app](https://developer.android.com/reference/android/telephony/SubscriptionManager.html#ACTION_MANAGE_SUBSCRIPTION_PLANS) for upgrade/upsell opportunities.\n- The data usage warning and limit notification thresholds are automatically configured based on the plan details; the warning is set to 90% of the limit.\n- If the carrier temporarily indicates the network is [\"congested\"](https://developer.android.com/reference/android/telephony/SubscriptionManager.html#setSubscriptionOverrideCongested(int,%20boolean,%20long)), the OS delays JobScheduler jobs that can be time-shifted, reducing the load on the carrier network.\n- If the carrier temporarily indicates the network is [\"unmetered\"](https://developer.android.com/reference/android/telephony/SubscriptionManager#setSubscriptionOverrideUnmetered(int,%20boolean,%20long)), the OS can report the cellular connection as \"unmetered\" until the carrier clears the override, or until the timeout value (if provided) is reached.\n- By comparing the user's current data usage with the overall data limit, the OS estimates the user's normal data usage at the end of the billing cycle and conservatively allocates 10% of any surplus data to improve the user experience, for example, by letting apps use multi-path data.\n\nCustomization and validation\n----------------------------\n\nThe Android Settings app displays all carrier-configured data plan details,\nensuring that users see the most accurate status of their carrier relationship,\nand offering users a path into the carrier app to upgrade their plan. Device\nmanufacturers choosing to customize the Settings app are recommended to continue\nsurfacing these details.\n\nThe `SubscriptionManager` APIs described on this page are tested by\n`android.telephony.cts.SubscriptionManagerTest`, which ensures that data plan\ndetails can be configured by carrier apps and that changes are propagated within\nthe OS."]]
