wehub-resource-sync
71 lines
4.6 KiB
Markdown
71 lines
4.6 KiB
Markdown
---
|
|
layout: doc
|
|
outline: deep
|
|
---
|
|
|
|
# Estensione browser
|
|
|
|
MediaGo include una leggera estensione browser Manifest V3 che rileva URL video / audio scaricabili su qualsiasi sito e li invia a MediaGo con un clic.
|
|
|
|
## Cosa fa
|
|
|
|
- Rileva stream HLS / m3u8 e file multimediali diretti `.mp4` / `.flv` / `.mov` in ogni pagina visitata
|
|
- Riconosce pagine video Bilibili e URL YouTube video / short / live / embed
|
|
- Mostra il numero di risorse rilevate nel badge dell'icona della toolbar
|
|
- Importa una singola sorgente o tutte le sorgenti in MediaGo con un clic (desktop o self-hosted)
|
|
|
|
## Installazione
|
|
|
|
L'estensione non è ancora su Chrome Web Store, quindi deve essere caricata come "estensione non pacchettizzata". L'installer di MediaGo Desktop la include già: non devi scaricarla separatamente.
|
|
|
|
1. Apri MediaGo Desktop
|
|
2. Vai in **Impostazioni → Altre impostazioni → Directory estensione browser** e clicca il pulsante per aprire la cartella dell'estensione
|
|
3. In Chrome / Edge, visita `chrome://extensions/`
|
|
4. Attiva **Modalità sviluppatore** in alto a destra
|
|
5. Clicca **Carica estensione non pacchettizzata** e seleziona la cartella aperta al punto 2
|
|
6. Dovresti vedere l'icona dell'estensione nella toolbar: fissala per accedervi più facilmente
|
|
|
|
## Modalità di invio
|
|
|
|
Clicca l'icona ingranaggio nel popup per aprire la pagina opzioni, poi scegli una modalità:
|
|
|
|
| Modalità | Quando usarla | Richiede |
|
|
| ----------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
|
| **Desktop · Protocollo schema** | MediaGo Desktop installato localmente; il browser può passare link protocollo | Nessuna configurazione; la prima chiamata mostra "Aprire MediaGo?" — spunta "Consenti sempre" per l'invio silenzioso successivo |
|
|
| **Desktop · HTTP locale** (default) | MediaGo Desktop installato e in esecuzione | Nessuna configurazione; l'estensione si connette a `127.0.0.1:39719` |
|
|
| **Docker / Self-hosted · HTTP** | Connessione a un server MediaGo remoto, ad esempio Docker | URL server richiesto; API Key se il server è avviato con `--enable-auth` |
|
|
|
|
> **L'estensione non effettua mai fallback silenziosi.** Una volta scelta una modalità, qualsiasi errore viene mostrato così com'è: cambia modalità manualmente nella pagina opzioni se necessario.
|
|
|
|
## Comportamento di importazione
|
|
|
|
Due toggle nella pagina opzioni sotto **Comportamento importazione**:
|
|
|
|
- **Avvia download subito** — On: l'attività viene messa in coda e avviata. Off: viene solo aggiunta alla lista, in attesa dell'avvio manuale. Vale per Schema e HTTP.
|
|
- **Importazione silenziosa (modalità Schema)** — On: il deeplink include `silent=1` e MediaGo crea subito l'attività. Off: MediaGo apre il modulo download precompilato con nome / tipo / cartella rilevati per la revisione. Vale solo in modalità Schema; HTTP è sempre silenzioso.
|
|
|
|
## Lingua interfaccia
|
|
|
|
L'estensione supporta cinese, inglese e italiano. Per impostazione predefinita segue la lingua UI del browser. Puoi forzare la scelta nella pagina opzioni sotto **Lingua interfaccia**: Segui sistema / 中文 / English / Italiano.
|
|
|
|
## Risoluzione problemi
|
|
|
|
### Il pulsante "Directory estensione browser" non fa nulla
|
|
|
|
- **Sviluppo**: esegui prima `pnpm -F @mediago/extension build` per generare la dist
|
|
- **Produzione**: reinstalla MediaGo: la cartella `resources/extension/` dovrebbe esistere nella directory di installazione dell'app
|
|
|
|
### Il test connessione Desktop · HTTP fallisce
|
|
|
|
- Verifica che MediaGo Desktop sia in esecuzione
|
|
- Verifica che la porta `39719` non sia occupata da un altro processo (`netstat -ano | findstr 39719` su Windows)
|
|
- Se esegui anche MediaGo in modalità web/server locale, nota che Go Core standalone usa `9900`, non `39719`
|
|
|
|
### La modalità Schema chiede conferma ogni volta
|
|
|
|
Al primo passaggio Chrome mostra "Aprire MediaGo-community?": spunta **Consenti sempre**. Le chiamate successive saranno silenziose.
|
|
|
|
### La modalità Schema fallisce con l'importazione batch
|
|
|
|
Schema invia una sola attività per chiamata: è una limitazione fondamentale dei protocolli di hand-off. Passa alla modalità HTTP (Desktop o Docker) per importazioni batch.
|