API de Symfonium (permitir el control desde otras apps como Tasker)

Requiere v1.7+

Symfonium expone una API que permite que otras aplicaciones interactúen con él.

La API es accesible mediante un receptor de Broadcast, así que solo tienes que enviar intents de broadcast correctos.

El nombre del componente receptor es “app.symfonik.music.player/app.symfonium.remote.api.ApiReceiver”

Para las apps que separan el componente, esto da:

Paquete : “app.symfonik.music.player”
Clase: “app.symfonium.remote.api.ApiReceiver”
Tipo de componente: Broadcast

Rellena el valor de acción del Intent con la API que quieras llamar y añade los extras como se documenta a continuación.

Cambiar reproductor

Acción API: “app.symfonium.api.SELECT_RENDERER”
Extras :
- “TYPE” [Int]: el tipo de reproductor Valor posible:
  - 0 : Dispositivo local
  - 1: Reproductor UPnP
  - 3 : Reproductor Chromecast
  - 6 : Media Center remoto
- “IDENTIFIER” [String/Opcional]: el ID único del reproductor El valor se puede ver desde la pantalla de emisión pulsando el botón (i). Puedes mantener pulsado el reproductor para copiar automáticamente el valor al portapapeles. (Solo es opcional para volver al dispositivo local)

Forzar sincronización

Acción API: “app.symfonium.api.MEDIA_SYNC”
Extras :
- “PROVIDER_ID” [Int]: el ID del proveedor (se puede ver en el menú de hoja inferior de los proveedores en ajustes)

Control de reproducción

Acción API: “app.symfonium.api.MEDIA_COMMAND”
Extras :
- “COMMAND” [String]: el comando que quieres enviar Valor posible:
  - “play”
  - “pause”
  - “stop”
  - “next”
  - “previous”
  - “shuffle”
  - “repeat”
  - “mute”
  - “togglemute”
  - “seek_relative” (posición relativa en segundos como parámetro int)
  - “seek” (posición en segundos como parámetro int)
  - “volume” (volumen como parámetro int)
  - “set_sleeptimer” (retardo en minutos como parámetro int) Requiere v6.0+
  - “remove_sleeptimer” Requiere v6.0+
- “INT_PARAMETER” [Int/Opcional]: un valor int para los comandos que lo requieren

Inicio de medios

Acción API: “app.symfonium.api.MEDIA_START”
Extras :
- “MEDIA_TYPE” [String]: el tipo de medio que iniciar Valor posible:
  - “playlist”
  - “artist”
  - “album”
  - “genre”
  - “song”
  - “song_mix”
  - “album_mix”
  - “internet_radio” Requiere v11.2+
- “NAME” [String/Opcional]: el nombre del medio (opcional para canciones si proporcionas el nombre de archivo). Requiere v1.9+
- “ALBUM” [String/Opcional]: el álbum del medio para desambiguación. Requiere v14.1+
- “ARTIST” [String/Opcional]: el artista del medio para desambiguación. Requiere v14.1+
- “ID” [Long/Opcional]: el Id de la radio o la lista (opcional si pasas el nombre). Requiere v11.2+
- “FILE” [String/Opcional]: la ruta completa del medio, solo para canciones. Requiere v1.9+
- “RESUME” [Boolean/Opcional]: si el medio debe reanudarse cuando sea posible.
- “SHUFFLE” [Boolean/Opcional]: para grupos de medios como listas / géneros, si el contenido debe mezclarse.
- “QUEUE” [Int/Opcional]: 1 para poner el medio en cola justo después del elemento en reproducción. 2 para poner el medio al final de la lista de reproducción. Requiere v1.8+

Cambio de ajuste

Requiere v1.10+

Acción API: “app.symfonium.api.CHANGE_SETTINGS”
Extras :
- “SETTING” [String]: el ajuste que cambiar
  
  Valor posible:
  - “wifi_transcode” : bitrate de transcodificación por Wifi
  - “mobile_transcode” : bitrate de transcodificación móvil
  - “available_offline” : filtro Disponible sin conexión Requiere v3.2+
  - “hide_status_bar” : alternar ocultar barra de estado Requiere v14.0+
  - “ignore_camera_hole” : alternar ignorar el recorte de la cámara Requiere v14.0+
- “INT_PARAMETER” [Int]: valor de transcodificación

 Valor posible para temporizador de apagado esperar fin de canción, ocultar barra de estado e ignore_camera_hole:
 * 0 : Desactivado
 * 1 : Activado

 Valor posible para filtro sin conexión:
 * 0 : Filtro desactivado
 * 1 : Filtro activado

Valor posible para transcodificación:
 * -1 : Sin transcodificación
 * 1 : 64 Kbps
 * 2 : 96 Kbps
 * 3 : 128 Kbps
 * 4 : 160 Kbps
 * 5 : 192 Kbps
 * 6 : 256 Kbps
 * 7 : 320 Kbps

Importación de listas

Requiere v8.0+

Importa las listas desde un proveedor de medios compatible. Las listas existentes se omiten automáticamente.

Acción API: “app.symfonium.api.PLAYLIST_IMPORT”
Extras :
- “PROVIDER_ID” [Int]: el ID del proveedor (se puede ver en el menú de hoja inferior de los proveedores en ajustes)
- “PLAYLIST_TYPE” [Int]: tipo de lista importada
  - 1: Sin conexión primero
  - 2: Solo lectura
  - 3: En línea primero

Regenerar miniatura de lista

Requiere v11.3+

Actualiza la miniatura de la lista a partir de las miniaturas de las canciones que contiene.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_playlist_thumbnail”
- “LONG_PARAMETER” [Long]: el ID de la lista (se puede ver en la parte superior de la hoja inferior de acciones de la lista)

Actualizar orden aleatorio estable de la lista

Requiere v12.1+

Actualiza la miniatura de la lista a partir de las miniaturas de las canciones que contiene.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “refresh_playlist_stable_random”
- “LONG_PARAMETER” [Long]: el ID de la lista (se puede ver en la parte superior de la hoja inferior de acciones de la lista)

Cargar una cola de medios

Requiere v12.0+

Carga una cola de medios y, opcionalmente, reanuda la reproducción.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_media_queue”
- “LONG_PARAMETER” [Long]: el ID de la cola de medios. (Se puede ver pulsando el icono de información en la hoja inferior de la cola de medios.
- “RESUME” [Boolean]: true para reanudar la reproducción después de cargar la cola.

Regenerar miniatura de género

Requiere v11.5+

Actualiza la miniatura del género a partir de las miniaturas de las canciones que contiene.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_genre_thumbnail”
- “NAME” [String]: el nombre del género (Nota: puedes usar el valor especial “--ALL--” para regenerar las miniaturas de todos los géneros; ten cuidado con la duración y el uso de batería)

Limpiar caché sin conexión

Requiere v11.3+

Activa la acción Limpiar desde la gestión de la caché sin conexión.

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

Iniciar copia de seguridad

Requiere v11.3+

Inicia una copia de seguridad con los ajustes seleccionados (debe pasarse la contraseña y al menos una opción)

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “start_backup”
- “PASSWORD” [String]: la contraseña de la copia de seguridad. OBLIGATORIO
- “SETTINGS” [Boolean]: si la copia debe contener esto.
- “PROVIDERS” [Boolean]: si la copia debe contener esto.
- “EQ_PROFILES” [Boolean]: si la copia debe contener esto.
- “INTERNET_RADIO” [Boolean]: si la copia debe contener esto.
- “PLAYLISTS” [Boolean]: si la copia debe contener esto.
- “AUTO_OFFLINE_RULES” [Boolean]: si la copia debe contener esto.
- “USER_DATA” [Boolean]: si la copia debe contener esto.
- “USER_DATA_ALL” [Boolean]: si la copia debe contener todos los datos de usuario (también requiere que los datos de usuario estén activados)
- “CUSTOM_IMAGES” [Boolean]: si la copia debe contener esto.
- “FILE_FAVORITES” [Boolean]: si la copia debe contener esto.
- “TAG_CACHE” [Boolean]: si la copia debe contener esto.

Cambiar la conexión activa del proveedor

Requiere v13.4+

Fuerza un proveedor a usar su conexión principal o secundaria.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “force_provider_connection”
- “PROVIDER_ID” [Long]: el ID del proveedor. OBLIGATORIO
- “ACTIVE_CONNECTION” [Int]: 1 para la conexión principal, 2 para la conexión secundaria. OBLIGATORIO.

Regenerar miniaturas de artistas

Requiere v13.5+

Actualiza la miniatura del artista a partir de las miniaturas de las canciones que contiene.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “generate_artist_thumbnail”
- “ONLY_MISSING_THUMBNAIL” [Boolean]: cuando es true, solo actualiza artistas sin una miniatura ya definida.
- “NAME” [String]: el nombre del artista (Nota: puedes usar el valor especial “--ALL--” para regenerar las miniaturas de todos los artistas; ten cuidado con la duración y el uso de batería)

Cargar estilo de aplicación

Requiere v13.6+

Carga un estilo de aplicación personalizado guardado.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_app_style”
- “NAME” [String]: el nombre del estilo de aplicación

Cargar perfil

Requiere v13.6+

Carga un perfil guardado.

Acción API: “app.symfonium.api.CUSTOM_ACTION”
Extras :
- “ACTION” [String]: “load_profile”
- “NAME” [String]: el nombre del perfil

Volver al Wiki