À quoi sert «requestCode» sur PendingIntent?

Contexte:

J'utilise PendingIntent pour les alarmes via AlarmManager.

Le problème:

Au début, j'ai pensé que pour annuler les précédents, je devais fournir le requestCode exact que j'ai utilisé auparavant pour déclencher l'alarme.

Mais ensuite, j'ai découvert que j'avais tort, comme le dit l' API d'annulation :

Supprimez toutes les alarmes avec une intention correspondante. Toute alarme, de tout type, dont l'intention correspond à celle-ci (telle que définie par filterEquals (Intent)), sera annulée.

en regardant " filterEquals ", la documentation dit:

Déterminez si deux intentions sont identiques aux fins de la résolution d'intention (filtrage). Autrement dit, si leur action, leurs données, leur type, leur classe et leurs catégories sont identiques. Cela ne compare aucune donnée supplémentaire incluse dans les intentions.

donc je ne comprends pas à quoi sert le "requestCode" ...

La question:

À quoi sert "requestCode"?

Que faire si je crée plusieurs alarmes avec le même "requestCode"? se substituent-ils les uns aux autres?

1. requestCode est utilisé pour récupérer ultérieurement la même instance d'intention en attente (pour l'annulation, etc.).
2. Oui, je suppose que les alarmes se neutraliseront. Je garderais les codes de demande uniques.

Je veux juste ajouter à la réponse @Minhaj Arfin

1- requestCode est utilisé pour obtenir la même intention en attente plus tard (pour l'annulation, etc.)

2- Oui, ils seront remplacés tant que vous spécifiez le même Receiver à votre intention que vous spécifiez sur votre PendingIntent

exemple:

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);

De l'exemple ci-dessus, ils ne se remplaceront pas car le récepteur est différent (AlarmReceiverFirst et 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);

De l'exemple ci-dessus, ils se remplaceront, car le récepteur est le même (AlarmReceiverSecond)

dans mon cas, je veux ouvrir la même activité avec deux intentions différentes, donc si deux ou plusieurs FCMS sont là dans le bac, l'un d'eux n'ouvrira que l'autre ne le sera pas, donc j'ai changé les codes de demande d'intention en attente, puis cela a fonctionné.

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

Une chose importante à ce sujet requestCodequi gênera sérieusement votre application est l'utilisation de widgets. Les widgets ne fonctionneront pas après le redémarrage du téléphone s'ils requestCodesont identiques. cela signifie que le pendingIndentparamètre que vous définissez sur le remoteViewsde votre widget doit être défini comme un requestCode unique, généralement le widgetId accompagnant un nombre.

En fait, la documentation indique clairement à quoi sert le code de requête:

Si vous avez vraiment besoin de plusieurs objets PendingIntent distincts actifs en même temps (par exemple pour les utiliser comme deux notifications qui sont toutes les deux affichées en même temps), vous devrez vous assurer qu'il y a quelque chose de différent à leur sujet pour les associer à des PendingIntents. Il peut s'agir de n'importe lequel des attributs Intent considérés par Intent # filterEquals (Intent), ou de différents entiers de code de requête fournis à getActivity (Context, int, Intent, int), getActivities (Context, int, Intent [], int), getBroadcast ( Context, int, Intent, int) ou getService (Context, int, Intent, int).

Puisqu'il semble que ce n'est toujours pas si clair, laissez-moi essayer d'expliquer:

Lorsque vous souhaitez utiliser un PendingIntentobjet, vous ne vous contentez pas d'en instancier un. Au contraire, vous obtenez un à partir du système en utilisant les PendingIntentméthodes statiques ( getActivity, getBroadcast, getServiceetc.). Le système conserve un tas d'instances PendingIntent et vous en donne une. Lequel il vous donne, cela dépend des paramètres d'entrée que vous passez à ces méthodes getter. Ces paramètres d'entrée sont:, Contextc'est-à-dire le récepteur cible de l'intention, le Intentà utiliser, requestCodeet flags. Lorsque vous transmettez la même Context, la même requestCodeet la même intention (c'est-à-dire une intention filterEqualsavec une autre intention), vous obtenez le même PendingIntentobjet. Le fait est que le système veut avoir le moins d' PendingIntentobjets possible, donc il a tendance à réutiliser autant que possible les objets existants.

Par exemple, vous avez deux notifications de calendrier, pour deux dates différentes. Lorsque vous cliquez sur l'un d'entre eux, vous souhaitez que votre application s'ouvre à la date correspondante de cette notification. Dans ce scénario, vous avez la même Contextcible et l' Intentobjet que vous passez ne diffère que par EXTRA_DATA (qui spécifie la date qui doit être ouverte). Si vous fournissez la même chose requestCodelors de l'obtention de l' PendingIntentobjet, vous vous retrouverez avec le même PendingIntentobjet. Ainsi, lors de la création de la deuxième notification, vous remplacerez l'ancien Intentobjet par le nouveau EXTRA_DATA, et vous vous retrouverez avec deux notifications pointant vers la même date.

Si vous souhaitez avoir deux PendingIntentobjets différents , comme vous le devriez dans ce scénario, vous devez en spécifier un différent requestCodelors de l'obtention de l' PendingIntentobjet.