Dokumentáció / Hibaelhárítás / Az eszköz csak egy vagy néhány kampányt játszik le

Az eszköz csak egy vagy néhány kampányt játszik le

Bevezetés és tájékozódás

A képernyő csak egy vagy néhány kampányt játszik le, pedig az eszköz adatlapján a Közzétett kampányok rész többet mutat. Az újraindítás nem segített. Ez az útmutató végigvezeti a beállítások ellenőrzésén, a lejátszási listák összehasonlításán és a tartalomfrissítést akadályozó médiafájl azonosításán.

A lejátszási lista a kampányokat és lejátszási szabályaikat tartalmazó lista. Ha a lejátszó nem tud előkészíteni egy, az új listához szükséges médiafájlt, tovább használhatja a korábbi listát. További lehetséges ok az ütemezés, a kampánycélzás, a kapcsolat és a szabad tárhely.

Ellenőrzések és hibaelhárítás

Módosítás előtt diagnosztizálja a problémát. Az 1–6. lépés csak az aktuális állapotot ellenőrzi. A 7. lépés a portálon módosítja a kampányt; a 8. lépés rövid időre leállítja a lejátszást, és egy fájlt módosít. Ne törölje tömegesen a lejátszási listákat, médiafájlokat vagy az adatbázist.

Diagnosztikai és javítási eljárás

  1. Ellenőrizze a kampányokat a portálon.

    Nyissa meg az érintett eszköz adatlapját és a Közzétett kampányok lapot. A hiányzó kampányoknál ellenőrizze, hogy erre az eszközre vannak-e célozva, aktívak-e, illetve érvényesek-e a kezdési és befejezési dátumok és a lejátszási feltételek, a napokat és időpontokat is beleértve. A 3. lépésben vesse össze ezeket az eszköz tényleges idejével.

    Az éppen nem ütemezett kampány nem feltétlenül hibás. Ha most futnia kellene, és az újraindítás nem segített, folytassa. Lásd még az alábbi útmutatókat: Kampányok és Eszközök.

  2. Nyissa meg a Távoli konzolt.

    Az eszköz állapota legyen online , és kommunikáljon a szerverrel. A Távoli konzolhoz szükséges: Szerveradminisztrátor vagy magasabb szerepkör. A megnyitást az alábbi útmutató ismerteti: Távoli konzol . Illessze a parancsot a beviteli mezőbe, és küldje el a ✓ gombbal. A többsoros blokkokat teljes egészükben illessze be, az utolsó sorral együtt: PY.

    A távoli képernyő-előnézet nem ad konzolhozzáférést. Ha az eszköz offline, először kövesse ezt az útmutatót: Az eszköz kapcsolatának ellenőrzése. Ha szerepköre nem biztosít hozzáférést, kérjen meg jogosult adminisztrátort a lépések elvégzésére. Lásd: Felhasználók és jogosultságok.

    Az alábbi parancsok Linux-alapú lejátszókhoz használhatók az alábbi device-runtime.service szolgáltatással és az alábbi munkakönyvtárral: /storage. A Python-blokkokhoz Python 3, az URL-teszthez curl szükséges. Ha a konzol szerint egy parancs, szolgáltatás vagy elérési út nem létezik, ne folytassa fájlmódosítással. Forduljon a támogatáshoz.
  3. Ellenőrizze az időt, a lemezterületet és a lejátszó szolgáltatását.

    Másolható parancs:

    date
    df -h / /storage
    systemctl is-active device-runtime.service
    ls -lh --time-style=long-iso /storage/playlist /storage/playlist_new
    
    Mit lát?Mit jelent, és mi a következő lépés?
    Dátum és időVesse össze az aktuális helyi idővel és időzónával. A hibás idő befolyásolhatja a kampányválasztást és a kapcsolatot.
    Szabad hely az Avail oszlopbanHa a tárhely megtelt, kövesse ezt az útmutatót: Kevés szabad lemezterület. A /storage alá csatolt partíciót is ellenőrizze.
    activeA szolgáltatás fut. Ez még nem igazolja a helyes lejátszást vagy a sikeres frissítést.
    inactive, failed vagy hiányzó fájlokAz 5. lépésben ellenőrizze a naplókat. Az ideiglenes javítást csak a telepítés és az ok ellenőrzése után alkalmazza.

    /storage/playlist a lejátszó által jelenleg elfogadott lejátszási listát tartalmazza. /storage/playlist_new az újonnan fogadott listát tartalmazza, amelynek médiafájljait a lejátszó aktiválás előtt előkészíti. Az újabb időbélyeg vagy eltérő méret hasznos támpont, de önmagában nem bizonyít hibát. Normál letöltés közben is eltérhetnek átmenetileg a fájlok.

  4. Hasonlítsa össze a kampányokat a két lejátszási listában.

    Az alábbi blokk mindkét fájlt beolvassa, és felsorolja a numerikus eszközazonosítót, a kampányok számát, azonosítóit, neveit és érvényességi dátumait. Semmit sem módosít. Jegyezze fel a numerikus eszközazonosítót: a konzol fejlécében más azonosító is szerepelhet, amelyet később nem szabad a DEVICE_ID mezőben használni.

    Másolható parancs:

    python3 - <<'PY'
    import json
    for path in ['/storage/playlist', '/storage/playlist_new']:
        print('\nFILE:', path)
        try:
            with open(path) as f:
                data = json.load(f)
            print('Device:', data.get('deviceId'))
            campaigns = data.get('campaigns', [])
            print('Campaign count:', len(campaigns))
            for c in campaigns:
                print(c.get('campaignId'), c.get('nameCampaign'),
                      'from:', c.get('start'), 'to:', c.get('end'))
        except Exception as e:
            print('ERROR:', e)
    PY
    

    Ha az új lista tartalmazza a várt kampányokat, de az aktuálisban csak korábbi válogatás szerepel, a következő lépésben keressen előkészítési hibát. Ha a kampányok az új fájlból is hiányoznak, ellenőrizze a beállításokat és a portálfrissítések kézbesítését. A JSON-feldolgozási hiba hiányos vagy sérült fájlra utalhat; további ellenőrzés nélkül ne írja felül kézzel.

  5. Keresse meg a letöltési hibát, és ellenőrizze a szerver válaszát.

    Jelenítse meg az elmúlt 20 perc utolsó 120 szolgáltatásnapló-bejegyzését. Keressen ismétlődő hibákat, média-URL-t és azonosítót. Ha csak a hiba vége látszik, növelje az alábbi értéket: -n 120 vagy bővítse az időtartományt.

    Másolható parancs:

    sudo journalctl -u device-runtime.service --since "20 minutes ago" --no-pager -n 120 -o cat
    

    Mintakimenet — ne illessze be a konzolba. Példa az ezzel az eljárással megoldott hibára:

    https://files.screensoft.org/api/video/H265/1790935600695
    java.lang.IllegalStateException: Received 0 bytes ... /storage/video/1790935600695.mp4

    Received 0 bytes azt jelenti, hogy a lejátszó nem kapott használható fájltartalmat. Az üzenet önmagában nem magyarázza meg az okot. Ebben a példában a médiaazonosító: 1790935600695; saját esetén a naplóból jegyezze fel az azonosítót és a pontos URL-t.

    Illessze a napló pontos címét az alábbi kiemelt mezőbe; a rendszer automatikusan beilleszti a parancsba. Az idézőjeleket hagyja meg. A teszt eldobja a letöltött adatokat, és nem módosít médiafájlokat vagy lejátszási listákat. Ne használja automatikusan a példacímet másik eszközhöz.

    A pontos, https:// vagy http:// kezdetű címet illessze be. Ne a teljes hibaüzenetet vagy egy /storage/video/… elérési utat adjon meg.

    Hiányzik az URL. A parancs másolása egyelőre le van tiltva.

    2. Ellenőrizze a címet a parancsban, majd másolja a teljes blokkot. A cím automatikusan beillesztődik.

    Szerkeszthető és másolható parancs:

    curl -sS -L --connect-timeout 10 --max-time 30 \
      --range 0-1023 --max-filesize 1048576 \
      -D - -o /dev/null \
      -w '\nHTTP: %{http_code}\nDownloaded: %{size_download} bytes\n' \
      'PASTE_MEDIA_URL_HERE'
    
    Mit lát?Mit jelent, és mi a következő lépés?
    HTTP 404A szerver nem szolgáltatja a médiafájlt a kért címen. A 6. lépésben azonosítsa a kampányt, a 7.-ben pedig javítsa ki.
    HTTP 401 / 403A szerver megtagadta a hozzáférést. A támogatással ellenőriztesse a jogosultságokat és a szolgáltatás beállításait.
    HTTP 5xxSzerverhiba. Vizsgálja meg a fájlszolgáltatást; a lejátszási lista törlése nem javítja meg a szervert.
    DNS-, kapcsolódási, időtúllépési vagy TLS-hibaA konkrét hiba alapján ellenőrizze a hálózatot, a névfeloldást, a szerver elérhetőségét, az időt vagy a tanúsítványt. Ne kapcsolja ki a tanúsítvány-ellenőrzést.
    HTTP 200 / 206 és nem üres adatA teszt adatot fogadott. Ez nem igazolja a teljes videó hiánytalanságát vagy lejátszhatóságát; keressen további hibákat a naplókban.
    curl méretkorlátLehet, hogy a szerver figyelmen kívül hagyta az első 1024 bájtra vonatkozó kérést. A teszt korlátja 1 MiB és 30 másodperc; egy korlát elérése önmagában nem jelenti a médiafájl hibáját.
  6. Keresse meg a kampányt a médiaazonosító alapján.

    Először adja meg a médiaazonosítót. A piros 000 csak helyőrző. A blokk az alábbi mező pontos értékét keresi: resourceId az alternatív vizuális anyagokban is, és felsorolja a megfelelő kampányokat. Jegyezze fel a nevüket és azonosítójukat. A változatlan, 000 értékű blokk biztonságosan kilép, módosítás nélkül.

    Az 5. lépés média-URL-jének utolsó perjele utáni számot használja. Ez nem kampány- vagy eszközazonosító. A .mp4 kiterjesztés nélkül adja meg.

    Hiányzik az azonosító. Még ne másolja a parancsot.

    2. Ellenőrizze a pirossal kiemelt sort, majd másolja a teljes parancsot. Érvényes azonosító megadásakor a rendszer automatikusan beilleszti azt a parancsba, és engedélyezi a Másolás gombot.

    Szerkeszthető és másolható parancs:

    python3 - <<'PY'
    import json
    RESOURCE_ID = 000  # YOUR MEDIA ID MUST GO HERE
    if RESOURCE_ID <= 0:
        raise SystemExit('Enter the media ID in RESOURCE_ID first.')
    with open('/storage/playlist_new') as f:
        data = json.load(f)
    def contains_resource(value):
        if isinstance(value, dict):
            return value.get('resourceId') == RESOURCE_ID or any(
                contains_resource(v) for v in value.values())
        if isinstance(value, list):
            return any(contains_resource(v) for v in value)
        return False
    found = False
    for c in data.get('campaigns', []):
        if contains_resource(c):
            found = True
            print('Campaign:', c.get('nameCampaign'))
            print('Campaign ID:', c.get('campaignId'))
            print('Primary visual:', c.get('primary'))
            print('Alternative visuals:', c.get('alternative'))
    if not found:
        print('Media not found in the new playlist. Check the latest logs and ID.')
    PY
    

    Ha nincs találat, a fájl időközben megváltozhatott. Ellenőrizze újra a legfrissebb naplókat és az új lejátszási listát. Ha több kampány használja ezt a médiafájlt, egyetlen kampány javítása nem feltétlenül elég; minden találatot vizsgáljon meg.

  7. Javítsa ki a kampányt a portálon.

    Nyissa meg a név és azonosító alapján azonosított kampányt. Cserélje le az elérhetetlen médiafájlt újonnan feltöltött fájlra, vagy ideiglenesen állítsa le a kampányt, és mentse a módosítást. Lásd az alábbi útmutatókat: Médiafájlok és Kampányok.

    Várja meg a frissített lista megérkezését és médiafájljainak letöltését. Az időigény a kapcsolattól és a fájlmérettől függ. Ismételje meg a 3–4. lépés ellenőrzéseit: ha leállította a kampányt vagy lecserélte a médiafájlt, az új lista már nem hivatkozhat a hibás fájlra.

    Ha a fájl változatlan, és továbbra is az eredeti hivatkozást tartalmazza, a frissített lista még nem érkezett meg. Ellenőrizze az online állapotot és a portálmódosítás mentését. Az újraindítás önmagában nem tud helyreállítani olyan fájlt, amelyre a szerver továbbra is HTTP 404-et ad. Ha átmenetileg szeretné helyreállítani a többi reklámot, folytassa a 8. lépéssel; egyébként a 9. lépésben ellenőrizze az eredményt.

  8. Ideiglenes helyi javítás biztonsági mentéssel.

    Szervizeljárás — rövid időre megszakítja a lejátszást. Csak a konkrét elérhetetlen médiafájl és kampányának megerősítése után használja. A szkript egy teljes kampányt távolít el az új listából, nem csupán annak videóját. A megfelelő eszközön és olyan időpontban futtassa, amikor rövid lejátszáskimaradás megengedhető.

    A szkript ellenőrzi az összes azonosítót, kizárólag a device-runtime.serviceszolgáltatást állítja le, mindkét fájlról biztonsági mentést készít az alábbi könyvtárba: /storage/playlist-backup-DATUM-CASmajd eltávolítja a megadott kampányt az alábbi fájlból: playlist_new , majd újraindítja a szolgáltatást. Nem írja felül közvetlenül az aktuális lejátszási listát, és nem töröl médiafájlt. Írás előtt mentést készít; ha a szerkesztés sikertelen, megpróbálja visszaállítani az eredeti új listát. A blokkon belüli hibánál a szolgáltatást is megpróbálja újraindítani, ha a szkript végig tud futni; áramkimaradást vagy kényszerített leállítást nem tud így kezelni.

    Futtatás előtt töltse ki mindhárom alábbi mezőt:

    • DEVICE_ID: a numerikus eszközazonosító a 4. lépésből.
    • CAMPAIGN_ID: a kampányazonosító a 6. lépésből.
    • RESOURCE_ID: az elérhetetlen médiafájl azonosítója a naplókból.

    Ne használja a példaazonosítókat, kivéve ha pontosan azt az esetet kezeli. A piros 000 értékek biztonsági védelmet jelentenek: a másolás az összes azonosító kitöltéséig tiltva marad, a változatlan szkript pedig nem módosít semmit. Legalább egy másik kampánynak az eszközön kell maradnia.

    1. Másolás előtt adja meg mindhárom azonosítót

    Minden szám más elemet azonosít. Ellenőrizze őket a 4. és 6. lépés alapján; ne használja automatikusan a példaértékeket.

    A 4. lépésből; nem a konzol fejlécében szereplő azonosító.

    A 6. lépésből; nem a médiaazonosító.

    Ugyanaz a médiaazonosító, amelyet a 6. lépésben ellenőrzött.

    Adja meg mindhárom azonosítót. A parancs másolása egyelőre tiltva van.

    2. Ellenőrizze a három pirossal kiemelt értéket, majd másolja a teljes blokkot. Futtatása rövid időre megszakítja a lejátszást. A szkript azt is ellenőrzi, hogy az eszköz-, kampány- és médiaazonosító megfelel-e a lejátszási lista tartalmának.

    Szerkeszthető és másolható parancs:

    sudo python3 - <<'PY'
    import json
    import shutil
    import subprocess
    from datetime import datetime
    from pathlib import Path
    
    DEVICE_ID = 000
    CAMPAIGN_ID = 000
    RESOURCE_ID = 000
    
    if min(DEVICE_ID, CAMPAIGN_ID, RESOURCE_ID) <= 0:
        raise SystemExit('Enter all three IDs first. Nothing has changed.')
    
    root = Path('/storage')
    path = root / 'playlist_new'
    service = 'device-runtime.service'
    
    def contains_resource(value):
        if isinstance(value, dict):
            return value.get('resourceId') == RESOURCE_ID or any(
                contains_resource(v) for v in value.values())
        if isinstance(value, list):
            return any(contains_resource(v) for v in value)
        return False
    
    def prepare():
        data = json.loads(path.read_text())
        if data.get('deviceId') != DEVICE_ID:
            raise RuntimeError('Device ID does not match.')
        matches = [c for c in data.get('campaigns', [])
                   if c.get('campaignId') == CAMPAIGN_ID]
        if len(matches) != 1 or not contains_resource(matches[0]):
            raise RuntimeError('Campaign or media does not match the specified IDs.')
        data['campaigns'] = [c for c in data['campaigns']
                             if c.get('campaignId') != CAMPAIGN_ID]
        if not data['campaigns']:
            raise RuntimeError('No campaigns would remain after exclusion.')
        return data
    
    prepare()
    backup = root / ('playlist-backup-' + datetime.now().strftime('%Y%m%d-%H%M%S-%f'))
    backup.mkdir()
    subprocess.run(['systemctl', 'stop', service], check=True)
    saved = False
    try:
        for name in ('playlist', 'playlist_new'):
            shutil.copy2(root / name, backup / name)
        saved = True
        data = prepare()
        path.write_text(json.dumps(data, ensure_ascii=False))
        print('Backup:', backup)
        print('Campaigns retained:', len(data['campaigns']))
    except Exception:
        if saved:
            shutil.copy2(backup / 'playlist_new', path)
        raise
    finally:
        subprocess.run(['systemctl', 'start', service], check=True)
    PY
    

    Sikeres futáskor a kimenet tartalmazza a mentés elérési útját és a megtartott kampányok számát. Az elérési utat őrizze meg a támogatás számára. Ha a szkript eltérő azonosítókat jelez, ne távolítsa el az ellenőrzéseket: térjen vissza a 4. vagy 6. lépéshez. Ha az írás, visszaállítás vagy szolgáltatásindítás sikertelen, küldje el a teljes kimenetet a támogatásnak; ne helyezze kézzel az új listát az aktuális helyére.

    Ez az ideiglenes javítás csak erre az eszközre hat. Nem módosítja a szerver beállításait. Egy későbbi frissítés újra kézbesítheti a hibás kampányt. A 7. lépés portáljavítását is végezze el. Egy másik hiányzó médiafájl továbbra is akadályozhatja az aktiválást.
  9. Ellenőrizze a lista aktiválását és a tényleges lejátszást.

    Körülbelül egy perc múlva ellenőrizze a szolgáltatást és a naplókat; nagy médiafájlok letöltésére hagyjon több időt. Ez a blokk nem módosít semmit.

    Másolható parancs:

    systemctl is-active device-runtime.service
    ls -lh --time-style=long-iso /storage/playlist /storage/playlist_new
    sudo journalctl -u device-runtime.service --since "2 minutes ago" --no-pager -o cat | tail -50
    

    A 4. lépés parancsával listázza újra a kampányokat. Az aktuális listának a várt új válogatást kell tartalmaznia, a szolgáltatásnak aktívnak kell lennie, az aktuális naplókban pedig már nem ismétlődhet ugyanaz a letöltési hiba. Az egyező fájlméret önmagában nem elég bizonyíték.

    Végül figyelje a fizikai képernyőt vagy annak távoli előnézetét egy teljes reklámcikluson át. Ellenőrizze, hogy az aktuális feltételeik szerint esedékes kampányok mind megjelennek-e. Időzített vagy lejátszási szüneteket használó kampányoknál ennek megfelelő megfigyelési időt válasszon.

  10. Ha a probléma továbbra is fennáll.

    • Másik médiaazonosító jelenik meg: ismételje meg az 5–6. lépést az új fájllal. Az előző akadály elfedhetett egy továbbit.
    • Az új lejátszási lista nem érkezett meg: ellenőrizze az online állapotot, a céleszközt és a kampánymódosítás mentését. A helyi szerkesztés nem igazolja a szerverfrissítések megfelelő kézbesítését.
    • A lista aktív, de egy reklám továbbra is hiányzik: ellenőrizze az ütemezési feltételeit és a további lejátszási hibákat. Ez az eljárás nem javít automatikusan minden videó- vagy ütemezési hibát.
    • A szolgáltatás nem fut: ellenőrizze az állapotát az alábbi paranccsal, és küldje el az eredményt a támogatásnak.

    Másolható parancs:

    sudo systemctl status device-runtime.service --no-pager

    Küldje el szoftverszolgáltatójának az eszközazonosítót, a hiba helyi időpontját időzónával együtt, a várt kampányneveket, mindkét kampánylistát, a releváns naplóhibát és az URL-teszt eredményét. Ha helyi javítást végzett, mellékelje a kimenetét és a mentés elérési útját is. Jelszavakat vagy bejelentkezési adatokat ne küldjön.

Nem találta meg, amit keresett?
Forduljon szoftverszolgáltatójához.