Symfonium-API (Steuerung durch andere Apps wie Tasker erlauben)

Erfordert v1.7+

Symfonium stellt eine API bereit, über die andere Anwendungen mit Symfonium interagieren können.

Die API ist über einen Broadcast-Receiver erreichbar. Sie müssen also nur passende Broadcast-Intents senden.

Der Komponentenname des Receivers lautet “app.symfonik.music.player/app.symfonium.remote.api.ApiReceiver”

Für Apps, die die Komponente aufteilen, ergibt das:

Paket : “app.symfonik.music.player”
Klasse: “app.symfonium.remote.api.ApiReceiver”
Komponententyp: Broadcast

Tragen Sie als Action-Wert des Intents die API ein, die Sie aufrufen möchten, und setzen Sie die Extras wie unten dokumentiert.

Renderer wechseln

API-Aktion: “app.symfonium.api.SELECT_RENDERER”
Extras :
- “TYPE” [Int]: der Renderer-Typ Möglicher Wert:
  - 0 : lokales Gerät
  - 1: UPnP-Player
  - 3 : Chromecast-Player
  - 6 : Remote Media Center
- “IDENTIFIER” [String/Optional]: die eindeutige ID des Renderers Den Wert sehen Sie auf dem Casting-Bildschirm über die Schaltfläche (i). Durch langes Drücken auf den Renderer können Sie den Wert automatisch in die Zwischenablage kopieren. (Nur optional, um zum lokalen Gerät zurückzukehren)

Synchronisierung erzwingen

API-Aktion: “app.symfonium.api.MEDIA_SYNC”
Extras :
- “PROVIDER_ID” [Int]: die Anbieter-ID (sichtbar im Bottom-Sheet-Menü der Anbieter in den Einstellungen)

Wiedergabesteuerung

API-Aktion: “app.symfonium.api.MEDIA_COMMAND”
Extras :
- “COMMAND” [String]: der zu sendende Befehl Möglicher Wert:
  - “play”
  - “pause”
  - “stop”
  - “next”
  - “previous”
  - “shuffle”
  - “repeat”
  - “mute”
  - “togglemute”
  - “seek_relative” (relative Position in Sekunden als int-Parameter)
  - “seek” (Position in Sekunden als int-Parameter)
  - “volume” (Lautstärke als int-Parameter)
  - “set_sleeptimer” (Verzögerung in Minuten als int-Parameter) Erfordert v6.0+
  - “remove_sleeptimer” Erfordert v6.0+
- “INT_PARAMETER” [Int/Optional]: ein int-Wert für Befehle, die ihn benötigen

Medienstart

API-Aktion: “app.symfonium.api.MEDIA_START”
Extras :
- “MEDIA_TYPE” [String]: der zu startende Medientyp Möglicher Wert:
  - “playlist”
  - “artist”
  - “album”
  - “genre”
  - “song”
  - “song_mix”
  - “album_mix”
  - “internet_radio” Erfordert v11.2+
- “NAME” [String/Optional]: der Name des Mediums (für Songs optional, wenn Sie den Dateinamen angeben). Erfordert v1.9+
- “ALBUM” [String/Optional]: das Album des Mediums zur Unterscheidung. Erfordert v14.1+
- “ARTIST” [String/Optional]: der Künstler des Mediums zur Unterscheidung. Erfordert v14.1+
- “ID” [Long/Optional]: die ID des Radiosenders oder der Playlist (optional, wenn Sie den Namen übergeben). Erfordert v11.2+
- “FILE” [String/Optional]: der vollständige Pfad des Mediums, nur für Songs. Erfordert v1.9+
- “RESUME” [Boolean/Optional]: ob das Medium nach Möglichkeit fortgesetzt werden soll.
- “SHUFFLE” [Boolean/Optional]: ob Inhalte bei Mediengruppen wie Playlist / Genre gemischt werden sollen.
- “QUEUE” [Int/Optional]: 1, um das Medium direkt hinter dem aktuell wiedergegebenen Element einzureihen. 2, um das Medium am Ende der Playlist einzureihen. Erfordert v1.8+

Einstellung ändern

Erfordert v1.10+

API-Aktion: “app.symfonium.api.CHANGE_SETTINGS”
Extras :
- “SETTING” [String]: die zu ändernde Einstellung
  
  Möglicher Wert:
  - “wifi_transcode” : Bitrate für WLAN-Transcoding
  - “mobile_transcode” : Bitrate für mobiles Transcoding
  - “available_offline” : Filter Offline verfügbar Erfordert v3.2+
  - “hide_status_bar” : Statusleiste ein-/ausblenden Erfordert v14.0+
  - “ignore_camera_hole” : Kameraausschnitt ignorieren umschalten Erfordert v14.0+
- “INT_PARAMETER” [Int]: Transcoding-Wert

 Mögliche Werte für den Sleep-Timer am Songende, hide_status_bar und ignore_camera_hole:
 * 0 : Deaktiviert
 * 1 : Aktiviert

 Mögliche Werte für den Offline-Filter:
 * 0 : Filter deaktiviert
 * 1 : Filter aktiviert

Mögliche Werte für Transcoding:
 * -1 : Kein Transcoding
 * 1 : 64 Kbps
 * 2 : 96 Kbps
 * 3 : 128 Kbps
 * 4 : 160 Kbps
 * 5 : 192 Kbps
 * 6 : 256 Kbps
 * 7 : 320 Kbps

Playlist-Import

Erfordert v8.0+

Importiert Playlists von einem unterstützten Medienanbieter. Bestehende Playlists werden automatisch übersprungen.

API-Aktion: “app.symfonium.api.PLAYLIST_IMPORT”
Extras :
- “PROVIDER_ID” [Int]: die Anbieter-ID (sichtbar im Bottom-Sheet-Menü der Anbieter in den Einstellungen)
- “PLAYLIST_TYPE” [Int]: Typ der importierten Playlist
  - 1: Offline zuerst
  - 2: Schreibgeschützt
  - 3: Online zuerst

Playlist-Miniaturansicht neu generieren

Erfordert v11.3+

Aktualisiert die Playlist-Miniaturansicht anhand der Miniaturansichten der enthaltenen Songs.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_playlist_thumbnail”
- “LONG_PARAMETER” [Long]: die Playlist-ID (sichtbar oben im Bottom Sheet der Playlist-Aktionen)

Stabile Zufallssortierung der Playlist aktualisieren

Erfordert v12.1+

Aktualisiert die stabile Zufallssortierung der Playlist.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “refresh_playlist_stable_random”
- “LONG_PARAMETER” [Long]: die Playlist-ID (sichtbar oben im Bottom Sheet der Playlist-Aktionen)

Medienwarteschlange laden

Erfordert v12.0+

Lädt eine Medienwarteschlange und setzt die Wiedergabe optional fort.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_media_queue”
- “LONG_PARAMETER” [Long]: die ID der Medienwarteschlange. (Sichtbar über das Info-Symbol im Bottom Sheet der Medienwarteschlange.
- “RESUME” [Boolean]: true, um die Wiedergabe nach dem Laden der Warteschlange fortzusetzen.

Genre-Miniaturansicht neu generieren

Erfordert v11.5+

Aktualisiert die Genre-Miniaturansicht anhand der Miniaturansichten der enthaltenen Songs.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_genre_thumbnail”
- “NAME” [String]: der Genre-Name (Hinweis: Sie können den speziellen Wert “--ALL--” verwenden, um die Miniaturansichten aller Genres neu zu generieren. Beachten Sie Dauer und Akkuverbrauch.)

Offline-Cache bereinigen

Erfordert v11.3+

Löst die Bereinigungsaktion aus der Verwaltung des Offline-Caches aus.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “cleanup_offline_cache”

Sicherung starten

Erfordert v11.3+

Startet eine Sicherung mit den ausgewählten Einstellungen (Passwort und mindestens eine Option müssen übergeben werden)

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “start_backup”
- “PASSWORD” [String]: das Sicherungspasswort. ERFORDERLICH
- “SETTINGS” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “PROVIDERS” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “EQ_PROFILES” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “INTERNET_RADIO” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “PLAYLISTS” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “AUTO_OFFLINE_RULES” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “USER_DATA” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “USER_DATA_ALL” [Boolean]: ob die Sicherung alle Benutzerdaten enthalten soll (Benutzerdaten müssen ebenfalls aktiviert sein)
- “CUSTOM_IMAGES” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “FILE_FAVORITES” [Boolean]: ob die Sicherung dieses Element enthalten soll.
- “TAG_CACHE” [Boolean]: ob die Sicherung dieses Element enthalten soll.

Aktive Anbieterverbindung ändern

Erfordert v13.4+

Erzwingt, dass ein Anbieter seine primäre oder sekundäre Verbindung verwendet.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “force_provider_connection”
- “PROVIDER_ID” [Long]: die ID des Anbieters. ERFORDERLICH
- “ACTIVE_CONNECTION” [Int]: 1 für die primäre Verbindung, 2 für die sekundäre Verbindung. ERFORDERLICH.

Künstler-Miniaturansichten neu generieren

Erfordert v13.5+

Aktualisiert die Künstler-Miniaturansicht anhand der Miniaturansichten der enthaltenen Songs.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_artist_thumbnail”
- “ONLY_MISSING_THUMBNAIL” [Boolean]: Wenn true, werden nur Künstler ohne bereits definierte Miniaturansicht aktualisiert.
- “NAME” [String]: der Künstlername (Hinweis: Sie können den speziellen Wert “--ALL--” verwenden, um die Miniaturansichten aller Künstler neu zu generieren. Beachten Sie Dauer und Akkuverbrauch.)

Anwendungsstil laden

Erfordert v13.6+

Lädt einen gespeicherten benutzerdefinierten Anwendungsstil.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_app_style”
- “NAME” [String]: der Name des Anwendungsstils

Profil laden

Erfordert v13.6+

Lädt ein gespeichertes Profil.

API-Aktion: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_profile”
- “NAME” [String]: der Name des Profils

Zurück zum Wiki