CAP

1. Crea una nuova playlist da attivare quando scatta un’allerta CAP.
2. Aggiungi il plugin «Allerta CAP» alla diapositiva. Progetta la diapositiva e scegli se, quando scatta l’allerta, nel segnaposto va inserita la descrizione o il titolo.
3. Applica un tag agli schermi su cui deve comparire l’allerta. Quando clicchi «Modifica» sul tag, vedi l’ID del tag.
4. Crea una nuova chiave API nella pagina Team (annota la chiave API).
5. Il tag si può ora attivare tramite l’API: https://api.playsignage.com/docs#tag/Tag/paths/1v11tags1%7Bid_tag%7D1alert/post
6. A seconda della regione, l’URL di base è https://eu-api.playsignage.com oppure https://us-api.playsignage.com

Provare l’attivazione dell’allerta è più tecnico, perché devi imitare la richiesta che invierebbe un fornitore di servizi di allerta. L’esempio qui sotto usa curl, che funziona su macOS e Linux. Su Windows puoi usare un programma chiamato Postman. Sostituisci l’URL (l’esempio usa us-api), tag_id e api_key con i tuoi valori. Aggiorna anche le date effective, onset ed expires nel payload, così l’allerta è nella finestra in cui è attiva quando viene attivata.

 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>'

Per annullare un’allerta in corso:

 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>'