API di Symfonium (controllo da altre app come Tasker)

Symfonium espone un’API che consente ad altre applicazioni di interagire con l’app.

L’API è accessibile tramite un ricevitore Broadcast, quindi devi soltanto inviare intent broadcast appropriati.

Il nome del componente ricevitore è “app.symfonik.music.player/app.symfonium.remote.api.ApiReceiver”.

Per le app che separano il componente, i valori sono:

• Pacchetto: “app.symfonik.music.player”
• Classe: “app.symfonium.remote.api.ApiReceiver”
• Tipo: Broadcast

Imposta il valore dell’azione dell’intent sull’API da chiamare e compila i parametri extra come documentato di seguito.

Cambiare renderer

• Azione API: “app.symfonium.api.SELECT_RENDERER”
• Parametri extra:
  • “TYPE” [Int]: tipo del renderer. Valori possibili:
    • 0: dispositivo locale
    • 1: player UPnP
    • 3: player Chromecast
    • 6: media center remoto
  • “IDENTIFIER” [String/facoltativo]: ID univoco del renderer. Puoi vedere il valore nella schermata di casting premendo il pulsante (i); tieni premuto il renderer per copiarlo automaticamente negli appunti. È facoltativo solo quando torni al dispositivo locale.

Forzare la sincronizzazione

• Azione API: “app.symfonium.api.MEDIA_SYNC”
• Parametri extra:
  • “PROVIDER_ID” [Int]: ID del provider, visibile nel menu del pannello inferiore dei provider nelle impostazioni.

Controllare la riproduzione

• Azione API: “app.symfonium.api.MEDIA_COMMAND”
• Parametri extra:
  • “COMMAND” [String]: comando da inviare. Valori possibili:
    • “play”
    • “pause”
    • “stop”
    • “next”
    • “previous”
    • “shuffle”
    • “repeat”
    • “mute”
    • “togglemute”
    • “seek_relative” (posizione relativa in secondi come parametro int)
    • “seek” (posizione in secondi come parametro int)
    • “volume” (volume come parametro int)
    • “set_sleeptimer” (ritardo in minuti come parametro int) Richiede v6.0+
    • “remove_sleeptimer” Richiede v6.0+
  • “INT_PARAMETER” [Int/facoltativo]: valore int per i comandi che lo richiedono.

Avviare un media

• Azione API: “app.symfonium.api.MEDIA_START”
• Parametri extra:
  • “MEDIA_TYPE” [String]: tipo di media da avviare. Valori possibili:
    • “playlist”
    • “artist”
    • “album”
    • “genre”
    • “song”
    • “song_mix”
    • “album_mix”
    • “internet_radio” Richiede v11.2+
  • “NAME” [String/facoltativo]: nome del media, facoltativo per le tracce se fornisci il nome file. Richiede v1.9+
  • “ALBUM” [String/facoltativo]: album del media, usato per eliminare le ambiguità. Richiede v14.1+
  • “ARTIST” [String/facoltativo]: artista del media, usato per eliminare le ambiguità. Richiede v14.1+
  • “ID” [Long/facoltativo]: ID della radio o della playlist, facoltativo se fornisci il nome. Richiede v11.2+
  • “FILE” [String/facoltativo]: percorso completo del media, solo per le tracce. Richiede v1.9+
  • “RESUME” [Boolean/facoltativo]: indica se riprendere il media quando possibile.
  • “SHUFFLE” [Boolean/facoltativo]: per gruppi multimediali come playlist o generi, indica se riprodurre i contenuti in shuffle.
  • “QUEUE” [Int/facoltativo]: 1 per accodare il media subito dopo quello in riproduzione; 2 per accodarlo alla fine della playlist. Richiede v1.8+

Modificare un’impostazione

Richiede v1.10+

• Azione API: “app.symfonium.api.CHANGE_SETTINGS”
• Parametri extra:

  • “SETTING” [String]: impostazione da modificare.

    Valori possibili:

    • “wifi_transcode”: bitrate di transcodifica Wi-Fi
    • “mobile_transcode”: bitrate di transcodifica su rete mobile
    • “available_offline”: filtro Disponibile offline Richiede v3.2+
    • “hide_status_bar”: mostra o nasconde la barra di stato Richiede v14.0+
    • “ignore_camera_hole”: attiva o disattiva l’esclusione del foro della fotocamera Richiede v14.0+

  • “INT_PARAMETER” [Int]: valore di transcodifica.

 Possible value for sleep timer wait end of song, hide status bar and ignore_camera_hole:
 * 0 : Disabled
 * 1 : Enabled

 Possible value for offline filter:
 * 0 : Filter disabled
 * 1 : Filter enabled

Possible value for transcoding:
 * -1 : No transcoding
 * 1 : 64 Kbps
 * 2 : 96 Kbps
 * 3 : 128 Kbps
 * 4 : 160 Kbps
 * 5 : 192 Kbps
 * 6 : 256 Kbps
 * 7 : 320 Kbps

Importare playlist

Richiede v8.0+

Importa le playlist da un media provider supportato. Le playlist esistenti vengono ignorate automaticamente.

• Azione API: “app.symfonium.api.PLAYLIST_IMPORT”
• Parametri extra:
  • “PROVIDER_ID” [Int]: ID del provider, visibile nel menu del pannello inferiore dei provider nelle impostazioni.
  • “PLAYLIST_TYPE” [Int]: tipo di playlist importata.
    • 1: prima offline
    • 2: sola lettura
    • 3: prima online

Rigenerare la miniatura di una playlist

Richiede v11.3+

Aggiorna la miniatura della playlist in base alle miniature delle tracce che contiene.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “generate_playlist_thumbnail”
  • “LONG_PARAMETER” [Long]: ID della playlist, visibile nella parte superiore del pannello inferiore delle azioni della playlist.

Aggiornare l’ordinamento casuale stabile di una playlist

Richiede v12.1+

Aggiorna la miniatura della playlist in base alle miniature delle tracce che contiene.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “refresh_playlist_stable_random”
  • “LONG_PARAMETER” [Long]: ID della playlist, visibile nella parte superiore del pannello inferiore delle azioni della playlist.

Caricare una coda multimediale

Richiede v12.0+

Carica una coda multimediale ed eventualmente riprende la riproduzione.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “load_media_queue”
  • “LONG_PARAMETER” [Long]: ID della coda multimediale, visibile premendo l’icona delle informazioni nel pannello inferiore della coda.
  • “RESUME” [Boolean]: true per riprendere la riproduzione dopo aver caricato la coda.

Rigenerare la miniatura di un genere

Richiede v11.5+

Aggiorna la miniatura del genere in base alle miniature delle tracce che contiene.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “generate_genre_thumbnail”
  • “NAME” [String]: nome del genere. Puoi usare il valore speciale “--ALL--” per rigenerare le miniature di tutti i generi; fai attenzione alla durata dell’operazione e al consumo della batteria.

Pulire la cache offline

Richiede v11.3+

Attiva l’azione Pulisci della gestione della cache offline.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “cleanup_offline_cache”

Avviare un backup

Richiede v11.3+

Avvia un backup con le impostazioni selezionate. Devi fornire la password e almeno un’opzione.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “start_backup”
  • “PASSWORD” [String]: password del backup. OBBLIGATORIA.
  • “SETTINGS” [Boolean]: indica se includere questo elemento nel backup.
  • “PROVIDERS” [Boolean]: indica se includere questo elemento nel backup.
  • “EQ_PROFILES” [Boolean]: indica se includere questo elemento nel backup.
  • “INTERNET_RADIO” [Boolean]: indica se includere questo elemento nel backup.
  • “PLAYLISTS” [Boolean]: indica se includere questo elemento nel backup.
  • “AUTO_OFFLINE_RULES” [Boolean]: indica se includere questo elemento nel backup.
  • “USER_DATA” [Boolean]: indica se includere questo elemento nel backup.
  • “USER_DATA_ALL” [Boolean]: indica se includere tutti i dati utente; richiede anche l’attivazione dei dati utente.
  • “CUSTOM_IMAGES” [Boolean]: indica se includere questo elemento nel backup.
  • “FILE_FAVORITES” [Boolean]: indica se includere questo elemento nel backup.
  • “TAG_CACHE” [Boolean]: indica se includere questo elemento nel backup.

Cambiare la connessione attiva del provider

Richiede v13.4+

Forza un provider a usare la propria connessione principale o secondaria.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “force_provider_connection”
  • “PROVIDER_ID” [Long]: ID del provider. OBBLIGATORIO.
  • “ACTIVE_CONNECTION” [Int]: 1 per la connessione principale, 2 per quella secondaria. OBBLIGATORIO.

Rigenerare le miniature degli artisti

Richiede v13.5+

Aggiorna la miniatura dell’artista in base alle miniature delle tracce che contiene.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “generate_artist_thumbnail”
  • “ONLY_MISSING_THUMBNAIL” [Boolean]: se true, aggiorna solo gli artisti che non dispongono già di una miniatura.
  • “NAME” [String]: nome dell’artista. Puoi usare il valore speciale “--ALL--” per rigenerare le miniature di tutti gli artisti; fai attenzione alla durata dell’operazione e al consumo della batteria.

Caricare uno stile dell’applicazione

Richiede v13.6+

Carica uno stile personalizzato dell’applicazione precedentemente salvato.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “load_app_style”
  • “NAME” [String]: nome dello stile dell’applicazione.

Caricare un profilo

Richiede v13.6+

Carica un profilo salvato.

• Azione API: “app.symfonium.api.CUSTOM_ACTION”
• Parametri extra:
  • “ACTION” [String]: “load_profile”
  • “NAME” [String]: nome del profilo.

Torna alla Wiki