Konfigurieren Sie Warnmeldungen für Push-Benachrichtigungen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer
  • Fügen Sie Push-Benachrichtigungen Geräusche und Farben hinzu, um Anwendern mitzuteilen, ob eine Nachricht dringend ist oder nur die Aufmerksamkeit der Anwender erfordert.

    Beispiel-JSON zum Hinzufügen von Sound zu Push-Benachrichtigungen

    Das folgende JSON-Objekt ist ein Beispiel dafür, wie Sie Ihrer Push-Benachrichtigung einen Ton hinzufügen. Der Name des im Beispiel verwendeten Tons lautet „NotificationAlert-2“.
    json["aps"]["sound"] = "NotificationAlert-2.caf";

    In der Tabelle am Ende dieses Themas sind alle verfügbaren Farben aufgelistet. Um den Ton jedes Tons zu hören, müssen Sie eine Benachrichtigung mit dem Zieltonparameter konfigurieren.

    Hinweis:
    Für jeden Ton haben Sie die Möglichkeit, die Länge des Rings zu kürzen, indem Sie das Suffix -Short hinzufügen. Sie können alle Farben außer NotificationAlert-5.caf kürzen.

    JSON-Beispiel für kritische Warnungen mit Ton

    Die folgende JSON-Datei zeigt, wie der Parameter „sound“ für kritische Warnungen definiert wird. Weitere Informationen zu kritischen Warnungen finden Sie unter Mobile kritische Warnungen.

    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-3-Short.caf", 
              "volume": 1.0 
          }; 
    
    Die Parameter im JSON-Beispielcode sind:
    • Der Parameter critical definiert die Benachrichtigung als kritische Warnung. 1 bedeutet, dass die kritische Warnung aktiv ist, und 0 bedeutet, dass sie inaktiv ist.
    • Der Parameter volume definiert die Lautstärke des Benachrichtigungstons. Der Bereich reicht von 0,1 als die stillste Stufe bis 1,0 als die lauteste Stufe.
    • Der Parameter name ist der Name des Tons, der aktiviert wird, wenn eine Push-Benachrichtigung gesendet wird. Bei kritischen Warnungen unter Berücksichtigung von Benutzerrhythmen mit einem dramatischen Ton.
      Hinweis:
      Wenn kein Wert name definiert ist, verwendet das System den Standardton der Anwendung. Wenn für eine Anwendung kein Warnton definiert ist, verwendet das System den Standardmelton des Geräts.

      Um den Ton jedes Tons zu hören, müssen Sie eine Benachrichtigung mit dem Zieltonparameter konfigurieren.

      Akzeptierte Werte sind in der Tabelle aufgeführt.
      Hinweis:
      Für jeden Ton haben Sie die Möglichkeit, die Länge des Rings zu kürzen, indem Sie das Suffix -Short hinzufügen. Sie können alle Farben außer NotificationAlert-5.caf kürzen.
      Akzeptierte Dateinamenwerte Tonrhythmus
      NotificationAlert-1.caf Sanft, Entspannend, Langsam
      Benachrichtigungswarnung-1-Kurz.caf Sanft, Entspannend, Langsam
      NotificationAlert-2.caf Drastisch
      Benachrichtigungswarnung-2-Kurz.caf Drastisch
      NotificationAlert-3.caf Drastisch
      Benachrichtigungswarnung-3-Kurz.caf Drastisch
      NotificationAlert-4.caf Sanft, Entspannend, Langsam
      Benachrichtigungswarnung-4-Kurz.caf Sanft, Entspannend, Langsam
      NotificationAlert-5.caf Sanft, Entspannend, Langsam
      NotificationAlert-6.caf Festlich, Fröhlich
      Benachrichtigungswarnung-6-Kurz.caf Festlich, Fröhlich
      NotificationAlert-7.caf Festlich, Fröhlich
      Benachrichtigungswarnung-7-Kurz.caf Festlich, Fröhlich
      NotificationAlert-8.caf Festlich, Fröhlich
      Benachrichtigungswarnung-8-Kurz.caf Festlich, Fröhlich
      NotificationAlert-9.caf Malerisch, Kraftvoll
      Benachrichtigungswarnung-9-Kurz.caf Malerisch, Kraftvoll
      NotificationAlert-10.caf Historisch, Spannend
      Benachrichtigungswarnung-10-Kurz.caf Historisch, Spannend
      NotificationAlert-11.caf Drastisch
      Benachrichtigungsalarm-11-Kurz.caf Drastisch
      NotificationAlert-12.caf Drastisch
      Benachrichtigungswarnung-12-Kurz.caf Drastisch
      NotificationAlert-13.caf Drastisch
      Benachrichtigungswarnung-13-Kurz.caf Drastisch
      NotificationAlert-14.caf Drastisch
      Benachrichtigungswarnung-14-Kurz.caf Drastisch
    Hinweis:
    Wenn kein Namenswert definiert ist, verwendet das System den Standardton der Anwendung. Wenn für eine Anwendung kein Warnton definiert ist, verwendet das System den Standardmelton des Geräts.