Ülevaade
CAP (Common Alerting Protocol) on standard, mida valitsused ja hädaolukorra ametid teadete jaoks kasutavad. Play võtab CAP-teated sinu teadete pakkujalt (näiteks Alertus või Raptor) vastu meie API kaudu ja näitab neid ekraanidel automaatselt.
- Ametlikud teated, nagu ohtlik ilm, evakuatsioonikorraldused, Amber alert ja tsiviilhädaolukorrad
- Valid ise, kuidas teated välja näevad ja millistel ekraanidel need ilmuvad
- Hädaolukorra sõnumid võivad tavalise sisu üle võtta
CAP töötab kõigil meediapleieritel, mida Play toetab, kui need on ühendatud. See on eriti oluline koolidele, ülikoolidele, haiglatele, valitsushoonetele ja kauplustele.
Alustamine
Play toetab protokolli, nii et kolmanda osapoole teatesüsteemid saavad saata ja käivitada teateid ekraanidel, kus jookseb Play. Lühidalt käib seadistus nii:
Seadista CAP-teated
- Loo uus esitlus, mis peaks käivituma, kui CAP-teade käivitub.
- Lisa slaidile plugin „CAP Alert“. Kujunda slaid ja vali, kas teate käivitumisel pannakse kohatäitesse teate kirjeldus või pealkiri.
- Lisa silt ekraanidele, millel teade peaks ilmuma. Kui klõpsad sildil „Muuda“, näed Tag ID-d.
- Loo lehel Teams uus API võti (Loo API võti) ja kirjuta võti üles.
- Silti saab nüüd API kaudu käivitada: https://api.playsignage.com/docs#tag/Tag/paths/
1v11tags1%7Bid_tag%7D1alert/post - Sõltuvalt piirkonnast on baasaadress kas https://eu-api.playsignage.com või https://us-api.playsignage.com
Teate käivituse testimine on tehnilisem, sest pead jäljendama päringut, mille teadete pakkuja saadaks. Allolev näide kasutab curli, mis töötab macOS-is ja Linuxis. Windowsis saad kasutada programmi Postman. Asenda aadress (näites on us-api), tag_id ja api_key oma väärtustega. Uuenda ka päringu sisus kuupäevi effective, onset ja expires, et teade oleks käivitamise hetkel oma aktiivses aknas.
curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
-H "Content-Type: application/xml" \
-H "Authorization: <api_key>" \
-d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
<identifier>ALERTUS_3716_164_20260302_203832</identifier>
<sender>PlaySignage Test</sender>
<sent>2026-03-07T19:00:00+00:00</sent>
<status>Actual</status>
<msgType>Alert</msgType>
<source>Alertus eEAS Server</source>
<scope>Public</scope>
<addresses>ALL</addresses>
<code>IPAWSv1.0</code>
<info>
<language>en-US</language>
<category>Safety</category>
<event>Local Area Emergency</event>
<responseType>None</responseType>
<urgency>Immediate</urgency>
<severity>Severe</severity>
<certainty>Observed</certainty>
<eventCode>
<valueName>SAME</valueName>
<value>LAE</value>
</eventCode>
<effective>2026-03-07T19:00:00+00:00</effective>
<onset>2026-03-07T20:00:00+00:00</onset>
<expires>2026-03-07T20:00:00+00:00</expires>
<headline>HEADLINE This is a TEST of the Alertus Emergency Notification system. NO ACTION IS NEEDED. In a real emergency, this message will contain important alert information.</headline>
<description>DESCRIPTION This is a TEST of the Alertus Emergency Notification system. NO ACTION IS NEEDED. In a real emergency, this message will contain important alert information.</description>
<parameter>
<valueName>EAS-ORG</valueName>
<value>EAS</value>
</parameter>
<area>
<areaDesc>Not specified</areaDesc>
<geocode>
<valueName>SAME</valueName>
<value>000000</value>
</geocode>
</area>
</info>
</alert>'Käimasoleva teate tühistamiseks:
curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
-H "Content-Type: application/xml" \
-H "Authorization: <api_key>" \
-d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
<identifier>ALERTUS_3716_164_20260302_203832_CANCEL</identifier>
<sender>PlaySignage Test</sender>
<sent>2026-03-07T19:00:00+00:00</sent>
<status>Actual</status>
<msgType>Cancel</msgType>
<source>Alertus eEAS Server</source>
<scope>Public</scope>
<addresses>ALL</addresses>
<code>IPAWSv1.0</code>
<info>
<language>en-US</language>
<category>Safety</category>
<event>Local Area Emergency</event>
<responseType>None</responseType>
<urgency>Immediate</urgency>
<severity>Severe</severity>
<certainty>Observed</certainty>
<eventCode>
<valueName>SAME</valueName>
<value>LAE</value>
</eventCode>
<effective>2026-03-07T19:00:00+00:00</effective>
<onset>2026-03-07T20:00:00+00:00</onset>
<expires>2026-03-07T20:00:00+00:00</expires>
<headline>This is a TEST of the Alertus Emergency Notification system. NO ACTION IS NEEDED. In a real emergency, this message will contain important alert information.</headline>
<description>This is a TEST of the Alertus Emergency Notification system. NO ACTION IS NEEDED. In a real emergency, this message will contain important alert information.</description>
<parameter>
<valueName>EAS-ORG</valueName>
<value>EAS</value>
</parameter>
<area>
<areaDesc>Not specified</areaDesc>
<geocode>
<valueName>SAME</valueName>
<value>000000</value>
</geocode>
</area>
</info>
</alert>'Korduma kippuvad küsimused
Mis on CAP ja kuidas see Play Digital Signage'is töötab?
CAP tähendab Common Alerting Protocol. See on rahvusvaheline standard, mida valitsused ja hädaolukorra ametid kasutavad ametlike teadete saatmiseks. Play Digital Signage võtab need teated automaatselt vastu ja saab neid ekraanidel reaalajas näidata.
Milliseid teadete pakkujaid te toetate?
Seni oleme töötanud koos alertus.com ja raptortech.com. Oleme avatud ka teiste teadete pakkujate integratsioonidele: võta ühendust.
