DesktopNotification

Avaa ChatGPT:ssä

25.00 Koe-aloite

Java API

DesktopNotification-komponentti näyttää natiivin työpöytäilmoituksia selaimen ikkunan ulkopuolella. Sitä voidaan käyttää varoittamaan käyttäjiä reaaliaikaisista tapahtumista, kuten uusista viesteistä, järjestelmävaroista tai tilamuutoksista, kun he käyttävät sovellustasi.

Asennus ja vaatimukset

Experimental feature

This feature is experimental and may change or be removed in a future release.

Aloittaaksesi tämän ominaisuuden käytön, lisää seuraava riippuvuus pom.xml-tiedostoon:

<dependency>
  <groupId>com.webforj</groupId>
  <artifactId>webforj-desktop-notification</artifactId>
</dependency>

Ennen kuin integroi DesktopNotification-komponentin, varmista, että:

• Sovelluksesi toimii turvallisessa ympäristössä (HTTPS).
• Selainta ei käytetä incognito- tai yksityisessä selaustilassa.
• Käyttäjä on ollut vuorovaikutuksessa sovelluksen kanssa (esim. napsauttamalla painiketta tai painamalla näppäintä), sillä ilmoitukset vaativat käyttäjäeleen näytettäväksi.
• Käyttäjä on myöntänyt ilmoituslupia (tätä pyydetään automaattisesti tarvittaessa).

Peruskäyttö

Ilmoituksen luomiseen ja näyttämiseen on useita tapoja. Useimmissa tilanteissa yksinkertaisin tapa on kutsua yhtä staattisista show-menetelmistä, jotka kapseloivat koko ilmoituksen elinkaaren.

Esimerkki: Perusilmoituksen näyttäminen

// Perusilmoitus, jossa on otsikko ja viesti
DesktopNotification.show("Päivitys saatavilla", "Latauksesi on valmis!");

Tämä yksi rivi luo ilmoituksen, jossa on otsikko ja sisältö, ja yrittää sitten näyttää sen.

Ilmoituksen mukauttaminen

Näytettävän ilmoituksen ulkoasun ja tuntuman mukauttamiseen on erilaisia vaihtoehtoja, riippuen sovelluksen tarpeista ja ilmoituksen tarkoituksesta.

Mukautetun Icon-kuvakkeen asettaminen

Oletusarvoisesti ilmoitus käyttää määriteltyä sovelluksen kuvaketta icons-protokollan kautta. Voit asettaa mukautetun kuvakkeen käyttämällä setIcon-menetelmää. Komponentti tukee erilaisia URL-skeemoja:

• context://: Ratkaistaan kontekstURL-osoitteeksi, joka osoittaa sovelluksen resurssikansioon; kuva on base64-koodattu.
• ws://: Ratkaistaan verkkopalvelimen URL-osoitteeksi, jolloin saadaan täydellinen URL-osoite.
• icons://: Ratkaistaan kuvakkeiden URL-osoitteeksi.

Esimerkki:

// Luodaan ilmoitus mukautetulla kuvakkeen URL-osoitteella
DesktopNotification notification = new DesktopNotification(
  "Muistutus", "Kokous alkaa 10 minuutin kuluttua."
);
notification.setIcon("context://images/custom-icon.png");
notification.open();

Ilmoitustapahtumat

DesktopNotification tukee useita elinkaaritapahtumia, ja kuuntelijoita voidaan liittää käsittelemään tapahtumia, kuten silloin, kun ilmoitus näytetään, suljetaan, napsautetaan tai ilmenee virhe.

Tapahtuma	Kuvaus	Milloin käyttää
Avaa	Käynnistyy, kun ilmoitus näytetään.	Kirjaa ilmoituksen näyttämisen, päivitä käyttöliittymä, seuraa sitoutumista.
Sulje	Käynnistyy, kun ilmoitus suljetaan.	Siivoa resurssit, kirjaa hylkäykset, suorita seuranta.
Virhe	Käynnistyy, kun ilmoituksessa tapahtuu virhe tai käyttäjä ei myöntänyt lupaa.	Käsittele virheitä sujuvasti, ilmoita käyttäjälle, käytä vaihtoehtoja.
Napsauta	Käynnistyy, kun käyttäjä napsauttaa ilmoitusta.	Siirry tiettyyn osioon, kirjaa vuorovaikutuksia, keskity sovellukseen.

DesktopNotification notification = new DesktopNotification("Hälytys", "Sinulla on uusi viesti!");

// Liitä tapahtumakuuntelija avaa tapahtumalle
notification.onOpen(event -> {
  System.out.println("Ilmoitus avattiin käyttäjän toimesta.");
});

// Samoin, kuuntele napsautustapahtumaa
notification.onClick(event -> {
  System.out.println("Ilmoitusta napsautettiin.");
});

Napsautuskäyttäytyminen

Selaimen turvallisuuspolitiikat estävät ilmoituksen napsautustapahtuman automaattisesti tuomasta sovelluksen ikkunaasi tai välilehteäsi etualalle. Tämä käyttäytyminen on selaimen määräämää, eikä sitä voi ohittaa ohjelmallisesti. Jos sovelluksesi vaatii ikkunan fokusta, sinun on ohjeistettava käyttäjiä napsauttamaan sovelluksen sisällä ilmoituksen vuorovaikutuksen jälkeen.

Turvallisuus- ja yhteensopivuusharkinnat

Kun käytät DesktopNotification-komponenttia, pidä mielessä seuraavat asiat:

• Turvallisuusympäristö: Sovelluksesi on toimitettava HTTPS:n yli varmistaaksesi, että ilmoitukset ovat sallittuja useimmissa moderneissa selaimissa.
• Käyttäjäeleen vaatimukset: Ilmoituksia näytetään vain käyttäjän aiheuttaman toiminnan jälkeen. Pelkkä sivun lataaminen ei käynnistä ilmoitusta.
• Selaimen rajoitukset: Ei kaikki selaimet käsittele mukautettuja kuvakkeita tai fokuskäyttäytymistä samalla tavalla. Esimerkiksi mukautetut kuvakkeet eivät ehkä toimi Safarissa, samalla kun tapahtumakäyttäytyminen voi vaihdella muissa selaimissa.
• Luvat: Tarkista aina, että sovelluksesi tarkistaa ja pyytää käyttäjältä ilmoituslupia sujuvasti.

Käyttö parhaat käytännöt

Pidä seuraavat parhaat käytännöt mielessä käytettäessä DesktopNotification-komponenttia sovelluksessasi:

• Tiedota käyttäjiäsi: Kerro käyttäjille, miksi ilmoituksia tarvitaan ja kuinka he voivat hyötyä niistä.
• Tarjoa vaihtoehtoja: Koska jotkut selaimet saattavat rajoittaa ilmoituksia, harkitse vaihtoehtoisia tapoja varoittaa käyttäjiä (esim. sovellusviestit).
• Virheiden käsittely: Rekisteröi aina virhekuuntelija, jotta voit sujuvasti hallita tilanteita, joissa ilmoitukset epäonnistuvat näkymään.