Kif jaħdem MousePlayer

Gwida sempliċi għall-arkitettura tat-traċċar, riżoluzzjonijiet bejn apparati u limiti tas-sistema.

1. Għaliex ma nirreġistrawx video

Spiss jaħsbu li għodod viżivi jirreġistraw video bħal MP4 jew WebM tal-iskrin. Dan juża ħafna bandwidth, inaqqas is-sit ħafna u joħloq test imċajpar li ma jinqarax.

Minflok nużaw teknoloġija ħafifa: Telemetrija tas-snapshot DOM. Dawn il-prinċipji bażiċi:

Stampa tal-istruttura

Meta tinfetaħ paġna, l-iskript jieħu "pjanta" testwali tal-HTML u stili. Jirreġistra fejn huma l-elementi bla kopja tal-immaġnijiet jew videos; il-player jgħabbi immaġnijiet mill-indirizz oriġinali. Canvas eċċezzjoni: il-kontenut jintbagħat bħala immaġni (ara taħt).

Telemetrija tal-koordinati

Nirreġistraw fluss ta’ avvenimenti: maws, fond tal-iskrolljar, miri tal-klikks, daqs tal-browser u bidliet tal-paġna; skont settings ukoll console, talbiet falluti jew bil-mod u Web Vitals. Movimenti żgħar; snapshots u bidliet jistgħu jkunu ferm akbar u jintbagħtu kompressati.

Riproduzzjoni tat-teatru

Fil-player tinbena l-paġna mill-pjanta rreġistrata u kursur virtwali jimxi f’ħin reali, bit-test ċar ħafna.

Mibni biex jibqa’ ħafif: l-iskript jitgħabba asinkronikament u jibgħat punti numeriċi żgħar minflok video. L-effett fuq Core Web Vitals jiddependi fuq paġni, hosting u network; kejlu fis-sit tagħkom minflok taċċettaw ċifra tagħna. Ebda veloċità garantita – ara taqsima 20 tat- Termini tas-Servizz.

2. Riżoluzzjonijiet & apparati mobbli

Minn smartphones żgħar sa monitors 4K ultra-wide, siti jbiddlu u jirranġaw layout għall-wisa’ — Responsive Web Design.

Kif inqabblu ż-żona viżibbli eżatta

Biex ma tidhirx distorta, nirreġistraw id-daqs eżatt (eż., 390x844 għal smartphone jew 1920x1080 għal desktop). Il-player joħloq sandbox skalat bl-istess proporzjon bħall-iskrin oriġinali.

Skrins desktop & laptop

Nirreġistraw maws kontinwu u navigazzjoni bejn tabs fl-istess sessjoni browser. Menus fuq hover jidhru jekk jibdlu d-dokument; hover CSS biss ma jidhirx fid-dokument u ma jiġix riprodott.

Smartphones & tablets

Touchscreens bla kursur hover. MousePlayer jadatta b’mess, swipe u bidliet tal-orjentazzjoni (portrait jew landscape).

Daqs li jinbidel waqt sessjoni

Rotazzjoni tat-tablet jew tibdil tat-tieqa jbiddel il-layout. MousePlayer jaqbad dawn l-avvenimenti u jadatta l-canvas tar-riproduzzjoni immedjatament, iżomm il-kuntest.

3. Limiti tas-sistema & konfini tekniċi

Għall-privatezza, sigurtà tal-browser u pproċessar veloċi, MousePlayer jaħdem f’limiti definiti:

Konfini tas-sistema Kif MousePlayer jittrattah
iFrames Iframes tal-istess origin jirreġistraw il-kontenut u l-interazzjoni. Origin ieħor (YouTube, Stripe) ma jistax jinqabad minn ġewwa minħabba Same-Origin Policy; jidher placeholder u ma jitgħabbiex fir-riproduzzjoni.
Oqsma sensittivi (PII) Passwords u ħlasijiet moħbija fuq l-apparat f’kull livell, u ħabi sħiħ l-istandard. Taraw ittajpjar, mhux it-test. Żewġ limiti: livelli aktar dgħajfa biss b’approvazzjoni bil-miktub, u ħabi ma jilħaqx dak stampat fil-paġna – indirizz fuq konferma parti mis-snapshot. It-tnejn fid- DPA.
Elementi Canvas & WebGL Canvas irreġistrat bħala immaġni mas-snapshot u kull bidla, sa madwar darba fis-sekonda u b’limitu tad-daqs. Animazzjoni tidher bħala frames. Ebda immaġni minn żoni moħbija jew canvas b’immaġnijiet ta’ origin ieħor; WebGL jista’ jibqa’ vojt.
Web Components (Shadow DOM) Shadow roots miftuħa jiġu rreġistrati bil-kontenut. Magħluqa inaċċessibbli għall-iskripts; il-kontenut nieqes.
Trasport & ħażna tal-browser Data fuq WebSocket kriptat (HTTPS/WSS). Jekk ma jistax, eż. proxy, tintuża triq HTTP kriptata; snapshots kbar ħafna jittellgħu separatament b’HTTPS. Ebda cookie; local storage u session storage fis-sit tagħkom.
Perjodi AFK inattivi Jekk viżitatur iħalli tab miftuħa u jitlaq 20 minuta, l-inattività tinstab u tiġi kompressata fir-riproduzzjoni biex ma taħlux ħin fuq skrin wieqaf.