O que é “requestCode” usado em PendingIntent?

Fundo:

Estou usando PendingIntent para alarmes via AlarmManager.

O problema:

A princípio pensei que, para cancelar os anteriores, devo fornecer o requestCode exato que usei antes para iniciar o alarme.

Mas então descobri que estava errado, como diz a API de cancelamento :

Remova todos os alarmes com um Intent correspondente. Qualquer alarme, de qualquer tipo, cujo Intent corresponda a este (conforme definido por filterEquals (Intent)), será cancelado.

olhando para " filterEquals ", a documentação diz:

Determine se duas intents são iguais para fins de resolução de intent (filtragem). Isto é, se sua ação, dados, tipo, classe e categorias são os mesmos. Isso não compara nenhum dado extra incluído nas intents.

então não entendi para que serve o "requestCode" ...

A questão:

Para que é usado "requestCode"?

E se eu criar vários alarmes com o mesmo "requestCode"? eles se sobrepõem?

1. requestCode é usado para recuperar a mesma instância de intent pendente posteriormente (para cancelamento, etc.).
2. Sim, meu palpite é que os alarmes irão se sobrepor um ao outro. Eu manteria os códigos de solicitação exclusivos.

Eu só quero adicionar a resposta de @Minhaj Arfin

1- requestCode é usado para obter a mesma intenção pendente posteriormente (para cancelamento, etc.)

2- Sim, eles serão substituídos, desde que você especifique o mesmo Receptor para seu Intent que você especificou em seu PendingIntent

exemplo:

Intent startIntent1 = new Intent(context, AlarmReceiverFirst.class);
PendingIntent pendingIntent1 = PendingIntent.getBroadcast(context, 0, startIntent1, 0);

Intent startIntent2 = new Intent(context, AlarmReceiverSecond.class);
PendingIntent pendingIntent2 = PendingIntent.getBroadcast(context, 0, startIntent2, 0);

Do exemplo acima, eles não se substituirão porque o receptor é diferente (AlarmReceiverFirst e AlarmReceiverSecond)

Intent startIntent2 = new Intent(context, AlarmReceiverSecond.class);
PendingIntent pendingIntent2 = PendingIntent.getBroadcast(context, 0, startIntent2, 0);

Intent startIntent3 = new Intent(context, AlarmReceiverSecond.class);
PendingIntent pendingIntent3 = PendingIntent.getBroadcast(context, 0, startIntent3, 0);

Do exemplo acima, eles se substituirão, porque o receptor é o mesmo (AlarmReceiverSecond)

no meu caso, quero abrir a mesma atividade com duas intents diferentes, portanto, se houver dois ou mais FCMS na bandeja, qualquer uma delas abrirá apenas a outra não, então mudei os códigos de solicitações de intents pendentes e funcionou.

 PendingIntent pendingIntent =
                            PendingIntent.getActivity(this, **Some unique id for all GCMS** /* Request code */, intent,
                                    PendingIntent.FLAG_ONE_SHOT);

uma coisa importante sobre requestCodeisso que vai causar problemas sérios ao seu aplicativo é quando usar widgets. widgets não funcionarão após a reinicialização do telefone se requestCodeforem iguais. isso significa que o que pendingIndentvocê definiu no remoteViewsde seu widget deve ser definido como requestCode exclusivo, geralmente o widgetId que acompanha um número.

Na verdade, a documentação afirma claramente para que o código de solicitação é usado:

Se você realmente precisa de vários objetos PendingIntent distintos ativos ao mesmo tempo (como para usar como duas notificações que são mostradas ao mesmo tempo), você precisará garantir que haja algo diferente sobre eles para associá-los a diferentes PendingIntents. Pode ser qualquer um dos atributos Intent considerados por Intent # filterEquals (Intent) ou diferentes números inteiros de código de solicitação fornecidos para getActivity (Context, int, Intent, int), getActivities (Context, int, Intent [], int), getBroadcast ( Context, int, Intent, int) ou getService (Context, int, Intent, int).

Como parece que ainda não está claro, deixe-me tentar explicar:

Quando você deseja usar um PendingIntentobjeto, não basta instanciar um. Em vez disso, você obter uma a partir do sistema usando os PendingIntentmétodos estáticos ( getActivity, getBroadcast, getServiceetc.). O sistema mantém várias instâncias PendingIntent e fornece uma. Qual ele fornece, depende dos parâmetros de entrada que você passa para esses métodos getter. Esses parâmetros de entrada são:, Contextou seja, o receptor alvo da intenção, a Intentusar requestCodee flags. Quando você passa o mesmo Context, o mesmo requestCodee mesmo Intent (ou seja, um intent filterEqualscom outro intent), você obtém o mesmo PendingIntentobjeto. A questão é que o sistema quer ter o mínimo de PendingIntentobjetos possível, então tende a reutilizar os existentes, tanto quanto possível.

Por exemplo, você tem duas notificações de calendário, para duas datas diferentes. Ao clicar em um deles, você deseja que seu aplicativo seja aberto na data correspondente dessa notificação. Nesse cenário, você tem o mesmo Contextdestino, e o Intentobjeto que você está passando difere apenas em EXTRA_DATA (que especifica a data que deve ser aberta). Se você fornecer o mesmo requestCodeao obter o PendingIntentobjeto, acabará com o mesmo PendingIntentobjeto. Assim, ao criar a segunda notificação, você irá substituir o Intentobjeto antigo pelo novo EXTRA_DATA, e ficará com duas notificações apontando para a mesma data.

Se você deseja ter dois PendingIntentobjetos diferentes , como deveria neste cenário, você deve especificar um diferente requestCodeao obter o PendingIntentobjeto.