Deze handleiding legt uit hoe u een Streaming Radio-abonnement volledig kunt opzeggen.

Inleiding

• Voor de meeste producten moet u de opzegging per e-mail bevestigen, anders worden er geen gegevens verwijderd.
• Lees deze andere handleiding om een audiostream uit uw Streaming Radio te verwijderen, zonder het volledige product te verwijderen.
• Eventuele openstaande kosten en kosten buiten het abonnement blijven verschuldigd.
• Een bevestiging van de opzegging wordt naar eventuele andere beheerders van de organisatie gestuurd.
• Bij beëindiging worden de back-ups onherroepelijk verwijderd, waardoor herstel niet meer mogelijk is.

De Streaming Radio-abonnement opzeggen

Om de opzegging van uw abonnement in gang te zetten:

1. Klik hier om naar het beheer van uw product in het Infomaniak-beheerportaal te gaan (hulp nodig?).
2. Klik op het menu met acties ⋮ dat rechts van het betreffende item staat.
3. Kies Annuleren:
   
4. Volg de procedure tot het einde.

Deze handleiding legt uit hoe u een stream correct kunt configureren op de Infomaniak-radiostreamingservice.

Het streamen van een radiostream configureren

Om toegang te krijgen tot de radiostreamingservice:

1. Klik hier om naar het beheer van uw product in de Infomaniak Manager te gaan (hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product.
3. Klik op de naam van de radiozender.
4. Klik op de knop Feeds configureren:
   
5. Klik op de knop Feed toevoegen:
   
6. Voeg een standaardfeed toe (raad deze andere handleiding over feed-relay's).
7. Klik op de knop om verder te gaan: 
   
8. Selecteer de gewenste opties, waarbij u bijvoorbeeld HLS kunt activeren, wat niet wordt meegerekend in het totale aantal streams.
9. Configureer de gewenste kwaliteit en raadpleeg deze andere handleiding als u meer informatie zoekt over het type stream.
10. Pas indien nodig de buffergrootte aan (en vergeet niet om de wijzigingen op te slaan, indien nodig).
11. Klik op de knop om op te slaan en af te sluiten:
    

U kunt nu een applicatie configureren met de instellingen die u aan het einde van deze procedure heeft verkregen.

Deze handleiding behandelt de luistergegevens van Streaming Radio die kunnen worden geëxporteerd naar Mediapulse.

Inleiding

• Mediapulse, een onafhankelijke organisatie in Zwitserland, meet het bereik van radio, televisie en online platforms.
• Deze gegevens, die als de officiële referentie worden erkend, helpen de media- en advertentiemarkt bij het analyseren, vergelijken en structureren van hun activiteiten.
• Mediapulse staat onder toezicht van het DETEC via de OFCOM en waarborgt transparantie, onafhankelijkheid en wetenschappelijke nauwkeurigheid. Het garandeert betrouwbare metingen die zijn afgestemd op de evolutie van de media.
• U kunt uw radiologbestanden naar deze service exporteren.
• Raadpleeg ook deze andere handleiding over een vergelijkbare dienst, maar dan voor Frankrijk.

Het Mediapulse-certificaat beheren

Vereisten

• De organisatie waartoe de streamingdienst behoort, moet gevestigd zijn in Zwitserland.
• Neem contact op met deze dienst via e-mail om de Mediapulse-certificering te activeren:info@mediapulse.ch.
• Zodra het contract met hen is afgesloten,neem contact op met de Infomaniak-ondersteuningen geef de informatie over uw Mediapulse- en Infomaniak-contract door.

Om de activering of deactivering van de service te beheren:

1. Klik hier om naar het beheer van uw product in het Infomaniak-beheerportaal te gaan (hulp nodig?).
2. Klik rechtstreeks op de naam die aan het betreffende product is toegekend.
3. Klik op de naam van de betreffende audiostroom.
4. Klik op Instellingen in het linkermenu.
5. Schakel de export van logbestanden naar Mediapulse in of uit met de schakelaar:
   ‍

Deze handleiding legt uit hoe u de audiostreams die beschikbaar zijn op een van uw Infomaniak Streaming Radio's, kunt overzetten naar een andere radio die u in dezelfde organisatie heeft.

Audiostreams overzetten

Ga als volgt te werk:

1. Klik hier om toegang te krijgen tot het beheer van uw product in de Infomaniak Manager (Hulp nodig?).
2. Klik direct op de naam van het betreffende product.
3. Klik op het actiemenu ⋮ dat rechts van het betreffende item staat.
4. Selecteer Overzetten:
   
5. Zoek en bevestig de naam van de andere radio die u in dezelfde organisatie heeft.
6. Bevestig de overdracht:
   

Vernieuw indien nodig de pagina's van de manager om de weergegeven informatie bij te werken.

Deze handleiding gaat over de functie voor live-bediening (timeshift), waarmee uw luisteraars uw HLS-streams kunnen pauzeren, terugspoelen en vervolgens terugkeren naar de live-uitzending, met een terugspoelduur van maximaal 2 uur.

Inleiding

• In tegenstelling tot Timeshift Streaming Video, is er geen planningshulpmiddel beschikbaar voor radio.
• De functie voor herbeluisteren/terugspoelen is standaard uitgeschakeld in de speler, zodat u zelf kunt bepalen hoe de functie beschikbaar is voor uw publiek.

Live-bediening aanbieden aan luisteraars

Vereisten

• Maak of bewerk een HLS-stream in uw Streaming Radio-product.

Vervolgens:

1. Stel bij het maken (of bewerken) van een HLS-stream de bufferduur in tussen 00:00:25 en 02:00:00. Deze waarde, tussen 25 seconden en 2 uur, komt overeen met de maximale duur waarvoor luisteraars de live-uitzending kunnen terugspoelen en pauzeren, voordat ze terugkeren naar de live-uitzending. Het bepaalt de diepte van de live-bediening. Voorbeelden:
   
   • 00:00:25 → 05:00: minimale tolerantie voor korte pauzes.
   • 10:00 → 30:00: ideaal voor nieuws-/praatprogramma's.
   • 30:00 → 02:00:00: maximaal comfort voor muziekprogramma's en evenementen.
2. De functie 'Opnieuw afspelen' inschakelen in uw speler (raadpleeg deze andere handleiding) als u deze functie aan uw luisteraars wilt aanbieden (standaard uitgeschakeld):
   

Deze handleiding beschrijft HLS, een technologie die uw audio in segmenten verdeelt voor een betrouwbare, compatibele en goed schaalbare HTTP-streaming, ideaal voor mobiele gebruikers en grote doelgroepen.

Wat is HLS?

HLS (HTTP Live Streaming) is een protocol voor het streamen van audio, waarbij de audio wordt opgedeeld in kleine segmenten van enkele seconden en een manifestbestand .m3u8 wordt gepubliceerd, waarin deze segmenten worden vermeld. De speler downloadt deze segmenten via HTTP/HTTPS (poorten 80/443), wat het eenvoudig maakt om ze te cachen, de stream na een onderbreking te hervatten en op grote schaal te distribueren.

In uw radiostreamingservice voegt het activeren van HLS een extra stream toe. Deze stream heeft een eigen URL voor het afspelen (HLS-manifest) en kan in de infomaniak-speler worden geselecteerd en geprioriteerd. De HLS-stream bestaat naast uw bestaande streams (bijv. MP3/AAC) en veroorzaakt geen onderbrekingen in de service.

Voordelen voor een radiostream

• Uitgebreide compatibiliteit: native ondersteuning op iOS/iPadOS (Safari) en brede ondersteuning via moderne HTML5-spelers en applicaties van derden.
• Schaalbaarheid en prestaties: distributie via HTTP(S), eenvoudig te distribueren via CDN en caches; betere schaalbaarheid dan een enkele, continue stream.
• Betrouwbaarheid: bij kleine onderbrekingen kan de speler de volgende segmenten ophalen en snel verdergaan; minder gevoelig voor tijdelijke uitval.
• Netwerkdoorvoer: werkt op poort 80/443 en wordt daardoor doorgaans beter geaccepteerd door firewalls en proxy's van bedrijven dan bepaalde “ICY”-streams.
• Vereenvoudigde HTTPS: veilige levering zonder plug-in of exotisch protocol.
• Adaptieve bitrate (ABR): wanneer er meerdere varianten beschikbaar zijn, kan de speler automatisch overschakelen op basis van de netwerkkwaliteit om onderbrekingen tijdens het gebruik op de go op te vangen.
• Flexibele integratie: een afzonderlijk luisterpunt maakt het mogelijk om HLS als primaire, secundaire of back-upstroom in uw speler te gebruiken.

Specifieke kenmerken en aandachtspunten

• Latentie: HLS voegt doorgaans een latentie toe van enkele tientallen seconden (gerelateerd aan de grootte van de segmenten en de buffering). Dit is normaal voor dit protocol.
• Vereiste compatibele speler: gebruik de Infomaniak-speler of een speler/web-SDK die .m3u8-manifesten ondersteunt.
• Diverse omgeving: sommige oudere hardware-ontvangers (webradio's, autoradio's met IP-connectiviteit) accepteren alleen MP3/Icecast-streams; behoud hun oude URL's naast de nieuwe.
• ABR-voorwaarde (conditionnel): de aanpassing van de bitrate is alleen effectief als er meerdere profielen zijn gepubliceerd; anders blijft de HLS-stream functioneren in een enkele kwaliteit.

Deze handleiding legt uit hoe u de controle behoudt over uw streamingradio-MP3/AAC- of HLS-streams door bescherming in te schakelen met een unieke token, zodat u bijvoorbeeld kunt bepalen of een luisteraar uw radio kan beluisteren of niet.

Inleiding

• Bij elke verbinding stuurt u een verzoek naar de Infomaniak-API, die u vervolgens een unieke token terugstuurt met een beperkte en configureerbare geldigheidsduur.
• Deze token stelt iedereen die de token heeft in staat om de stream gedurende deze periode te gebruiken.
• U kunt een MP3/AAC- of HLS-stream onafhankelijk van elkaar beveiligen (net als de geolocatie, trouwens).
• Het inschakelen van de beperking vereist een wijziging van de streamconfiguratie, waarvoor enkele minuten nodig kunnen zijn om op de servers te worden doorgevoerd.

Een audiostream beveiligen met een unieke sleutel

Hiervoor hoeft u alleen naar de beperkingsparameters te gaan en de tokenbeveiliging in te schakelen voor de stream die u wilt beveiligen:

1. Klik hier om toegang te krijgen tot het beheer van uw product in de Infomaniak Manager (Hulp nodig?).
2. Klik rechtstreeks op de productnaam die aan het betreffende product is toegewezen:
   
3. Klik op:
   1. ofwel op de naam van de radio:
      
   2. of op Beperkingen in het linkermenu om beperkingen voor het hele product toe te passen:
      
4. Als u de bovenstaande optie a selecteert, klikt u vervolgens op Beperkingen in het linkermenu.
5. Selecteer indien nodig HLS.
6. Klik op het actiemenu ⋮ rechts naast het betreffende item.
7. Klik op Tokenbeperking:
   
   

Activeer vervolgens de beveiliging.

Let op: als u deze optie activeert, wordt de toegang tot de stream onmiddellijk geblokkeerd voor nieuwe verbindingen. Pas uw spelers aan om rekening te houden met de beperking, zoals in het volgende voorbeeld wordt weergegeven:

API-Radio-Token erstellen

Om toegang te krijgen tot de radio-API, moet u zich eerst authenticeren met een applicatietoken. Deze stap hoeft slechts één keer te worden uitgevoerd. Om dit applicatietoken te maken, kunt u deze andere handleiding raadplegen.

De scope is radio en de levensduur is onbeperkt, om te voorkomen dat u regelmatig een code moet regenereren. Zodra het token is gegenereerd, kopieert u het en plakt u het in het onderstaande voorbeeld.

Voorbeeld van gebruik in de programmeertaal PHP

Voor MP3/AAC of HLS kan de code in principe hetzelfde zijn, alleen de URL die in de POST-aanvraag wordt gebruikt, verandert van formaat.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

Wij zullen het token genereren. De URL voor het genereren van het token is als volgt samengesteld:

• Voor een MP3/AAC-stream

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

Voorbeeld voor het beveiligen van https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac: het pad wordt: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Voor een HLS-stream

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Voorbeeld voor het beveiligen van https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8: het pad wordt: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Voorbeeld in het geval van MP3/AAC, vergeet niet om aan te passen:

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

Het is belangrijk om te onthouden dat, als deze code op het moment van het laden van de pagina wordt gegenereerd, de luisteraar een bepaalde tijd (in seconden) heeft om de stream af te spelen. Na het verstrijken van deze tijd verloopt het token en kan de stream niet meer worden gestart, tenzij de pagina opnieuw wordt geladen. Afhankelijk van uw behoeften en uw gebruiksscenario, zal het noodzakelijk zijn om deze tijd zo goed mogelijk aan te passen.

U moet ook de afspeel-URL van uw stream hieronder vervangen door de aangegeven URL, waarbij de parameter $token aan het einde behouden blijft. En ten slotte wordt de speler weergegeven (hier een eenvoudige HTML5-tag, maar u kunt natuurlijk elke gewenste overlay toevoegen, waarbij het token wordt doorgegeven in de parameters $_GET van de URL).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";

Deze handleiding gaat over de statistieken van Streaming Radio, waarmee u onder andere eventuele onderbrekingen in de stream kunt bekijken.

Recente statistieken analyseren

U kunt deze informatie hier vinden:

1. Klik hier om naar het beheer van uw product in het Infomaniak-beheerportaal te gaan (hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product:
   
3. Klik op Statistieken in het menu aan de linkerkant:
   
4. Klik op Realtime-publiek in het linkermenu.
5. Selecteer een datum om de bijbehorende grafiek te laden.
6. Houd de muis over de eventuele gemarkeerde onderbrekingen om meer informatie te krijgen:
   
7. Zoom in op de grafiek met het muiswiel of door de periode te selecteren.
8. U kunt terugkeren naar het oorspronkelijke scherm door rechtsonder te klikken:
   

Deze handleiding beschrijft hoe u een speler configureert voor uw Infomaniak-webradio.

Vereisten

• Voeg een speler toe met behulp van het Infomaniak-sjabloon.

Configureer de opties van de Infomaniak-speler

Nadat u uw stream aan uw speler heeft gekoppeld en uw speler is aangemaakt:

1. Klik hier om naar het beheer van uw product in de Infomaniak Manager te gaan (hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product.
3. Klik in het linkermenu op Mijn spelers.
4. Klik op de naam van de speler die u wilt configureren (of voeg een nieuwe speler toe door op de knop bovenaan te klikken):
   

1. Tabblad Uiterlijk

Hier kunt u de grootte van de speler kiezen (groot, gemiddeld, klein of speler voor meerdere radio's) en het percentage van het scherm dat de speler inneemt.

U kunt de kleuren van de achtergrond, knoppen en tekst aanpassen:

Met een schakelaar kunt u de weergave van de afgespeelde nummers in- of uitschakelen, met of zonder de uitzendtijden:

• Lees aan het einde van deze handleiding meer over de details.

De speler kan het volgende weergeven:

• een afbeelding van de albumhoes of een vervangende afbeelding als deze niet beschikbaar is,
• een statische afbeelding (max. 3 MB),
• het logo van uw radiostation, dat u hier kunt aanpassen:
  
• een visualisatie van het audiospectrum (Spectrogram / Spectrum).

2. Tabblad Uitvoering

Hier kunt u uw radiostreams (HLS of niet) koppelen aan de speler die u aan het configureren bent.

Lees deze andere handleiding over de beschikbare opties voor het beheren van de live-uitzending:

3. Tabblad Miniatuurafbeeldingen (voorbeeldafbeelding van de media)

Hier kunt u de voorbeeldafbeelding (miniatuur) wijzigen die op de speler van de luisteraar wordt weergegeven wanneer de media wordt geladen, of niet beschikbaar/beperkt is:

4. Tabblad Spelerinformatie

Hier kunt u uw speler een naam geven en beslissen of u bepaalde elementen wilt weergeven of verbergen:

• de titel en de artiest in plaats van de naam van het radiostation,
• het aantal luisteraars,
• het Infomaniak-logo.

5. Tabblad Deelopties

Met een schakelaar (toggle switch) kunt u bepaalde services, zoals Facebook, in- of uitschakelen:

Zodra deze is ingeschakeld, wordt er een deelknop naar deze services weergegeven in uw speler:

Details van de afspeelgeschiedenis (tab #1)

Met de afspeelgeschiedenis kunt u de afgespeelde nummers (tussen 1 en 40) opnieuw beluisteren, maar alleen als uw stream van het type HLS is (u kunt dan een buffer instellen van 25 seconden tot 2 uur):

De functie voor terugspoelen en opnieuw beluisteren is standaard niet ingeschakeld: deze blijft optioneel om de beperkingen in bepaalde landen of bij bepaalde radiostations te respecteren. Zodra deze is ingeschakeld, kan de beheerder van de radio kiezen welke streams beschikbaar zijn voor afspelen (zie tab #2 hierboven), terwijl de luisteraar de afspeelkwaliteit kan selecteren in de speler:

Position & intégration de l'historique de diffusion

De lijst kan op verschillende manieren worden weergegeven:

• direct onder de speler,
• in de speler,
• of apart in de integratie van uw website…

Het is namelijk mogelijk om de geschiedenis in een tweede iframe weer te geven, los van de hoofdspeler. Voorbeeld van een URL voor de speler:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

En voor de historische gegevens:
https://player-radio.infomaniak.com/2/prod/history

De twee iframes moeten op dezelfde pagina worden ingebed en communiceren met elkaar om de geschiedenis bij te werken of een eerder afgespeeld nummer af te spelen.

Een tweede integratiemethode maakt het mogelijk om een zelfstandige geschiedenis weer te geven, zonder het hoofd-iframe. Voeg eenvoudig de ID van de speler toe aan de URL:
https://player-radio.infomaniak.com/2/prod/history/7cbaa24a-3510-47a4-b41e-b99218bfd507

Deze methode is bijvoorbeeld geschikt voor gebruikers van een andere speler die alleen de geschiedenis van de afgespeelde nummers willen weergeven.