API do Symfonium (Permitir controle por outros apps como Tasker)

O Symfonium expõe uma API que permite que outros aplicativos interajam com ele.

A API é acessível por um receptor de Broadcast, então basta enviar intents de broadcast corretos.

O nome do componente receptor é “app.symfonik.music.player/app.symfonium.remote.api.ApiReceiver”

Para apps que separam o componente, isso resulta em:

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

Preencha o valor de ação do Intent com a API que você deseja chamar e preencha os extras conforme documentado abaixo.

Alterar renderizador

• Ação API: “app.symfonium.api.SELECT_RENDERER”
• Extras :
  • “TYPE” [Int]: o tipo de renderizador Valor possível:
    • 0 : dispositivo local
    • 1: player UPnP
    • 3 : player Chromecast
    • 6 : Media Center remoto
  • “IDENTIFIER” [String/Optional]: o ID exclusivo do renderizador O valor pode ser visto na tela de transmissão ao pressionar o botão (i). Você pode manter pressionado o renderizador para copiar automaticamente o valor para a área de transferência. (Opcional apenas para voltar ao dispositivo local)

Forçar sincronização

• Ação API: “app.symfonium.api.MEDIA_SYNC”
• Extras :
  • “PROVIDER_ID” [Int]: o ID do provedor (visível no menu do painel inferior dos provedores nas configurações)

Controle de reprodução

• Ação API: “app.symfonium.api.MEDIA_COMMAND”
• Extras :
  • “COMMAND” [String]: o comando que você deseja enviar Valor possível:
    • “play”
    • “pause”
    • “stop”
    • “next”
    • “previous”
    • “shuffle”
    • “repeat”
    • “mute”
    • “togglemute”
    • “seek_relative” (posição relativa em segundos como parâmetro int)
    • “seek” (posição em segundos como parâmetro int)
    • “volume” (volume como parâmetro int)
    • “set_sleeptimer” (atraso em minutos como parâmetro int) Requer v6.0+
    • “remove_sleeptimer” Requer v6.0+
  • “INT_PARAMETER” [Int/Optional]: um valor int para os comandos que exigem isso

Início de mídia

• Ação API: “app.symfonium.api.MEDIA_START”
• Extras :
  • “MEDIA_TYPE” [String]: o tipo de mídia a iniciar Valor possível:
    • “playlist”
    • “artist”
    • “album”
    • “genre”
    • “song”
    • “song_mix”
    • “album_mix”
    • “internet_radio” Requer v11.2+
  • “NAME” [String/Optional]: o nome da mídia (opcional para músicas se você fornecer o nome do arquivo). Requer v1.9+
  • “ALBUM” [String/Optional]: o álbum da mídia para desambiguação. Requer v14.1+
  • “ARTIST” [String/Optional]: o artista da mídia para desambiguação. Requer v14.1+
  • “ID” [Long/Optional]: o ID da rádio ou da playlist (opcional se você passar o nome). Requer v11.2+
  • “FILE” [String/Optional]: o caminho completo da mídia, apenas para músicas. Requer v1.9+
  • “RESUME” [Boolean/Optional]: se a mídia deve ser retomada quando possível.
  • “SHUFFLE” [Boolean/Optional]: para grupos de mídia como playlist / gênero, se o conteúdo deve ser embaralhado.
  • “QUEUE” [Int/Optional]: 1 para colocar a mídia na fila logo depois do item em reprodução. 2 para colocar a mídia no fim da playlist. Requer v1.8+

Alterar configuração

Requer v1.10+

• Ação API: “app.symfonium.api.CHANGE_SETTINGS”
• Extras :

  • “SETTING” [String]: a configuração a alterar

    Valor possível:

    • “wifi_transcode” : taxa de bits de transcodificação por Wi-Fi
    • “mobile_transcode” : taxa de bits de transcodificação móvel
    • “available_offline” : filtro Disponível offline Requer v3.2+
    • “hide_status_bar” : alternar ocultar barra de status Requer v14.0+
    • “ignore_camera_hole” : alternar ignorar recorte da câmera Requer v14.0+

  • “INT_PARAMETER” [Int]: valor de transcodificação

 Valores possíveis para timer de desligamento ao fim da música, hide_status_bar e ignore_camera_hole:
 * 0 : Desativado
 * 1 : Ativado

 Valores possíveis para o filtro offline:
 * 0 : Filtro desativado
 * 1 : Filtro ativado

Valores possíveis para transcodificação:
 * -1 : Sem transcodificação
 * 1 : 64 Kbps
 * 2 : 96 Kbps
 * 3 : 128 Kbps
 * 4 : 160 Kbps
 * 5 : 192 Kbps
 * 6 : 256 Kbps
 * 7 : 320 Kbps

Importar playlists

Requer v8.0+

Importa playlists de um provedor de mídia compatível. Playlists existentes são ignoradas automaticamente.

• Ação API: “app.symfonium.api.PLAYLIST_IMPORT”
• Extras :
  • “PROVIDER_ID” [Int]: o ID do provedor (visível no menu do painel inferior dos provedores nas configurações)
  • “PLAYLIST_TYPE” [Int]: tipo de playlist importada
    • 1: Offline primeiro
    • 2: Somente leitura
    • 3: Online primeiro

Regenerar miniatura da playlist

Requer v11.3+

Atualiza a miniatura da playlist com base nas miniaturas das músicas que ela contém.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “generate_playlist_thumbnail”
  • “LONG_PARAMETER” [Long]: o ID da playlist (visível no topo do painel inferior de ações da playlist)

Atualizar ordenação aleatória estável da playlist

Requer v12.1+

Atualiza a ordenação aleatória estável da playlist.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “refresh_playlist_stable_random”
  • “LONG_PARAMETER” [Long]: o ID da playlist (visível no topo do painel inferior de ações da playlist)

Carregar uma fila de mídia

Requer v12.0+

Carrega uma fila de mídia e, opcionalmente, retoma a reprodução.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “load_media_queue”
  • “LONG_PARAMETER” [Long]: o ID da fila de mídia. (Pode ser visto pressionando o ícone de informação no painel inferior da fila de mídia.
  • “RESUME” [Boolean]: true para retomar a reprodução após carregar a fila.

Regenerar miniatura do gênero

Requer v11.5+

Atualiza a miniatura do gênero com base nas miniaturas das músicas que ele contém.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “generate_genre_thumbnail”
  • “NAME” [String]: o nome do gênero (Observação: você pode usar o valor especial “--ALL--” para regenerar as miniaturas de todos os gêneros; fique atento à duração e ao uso de bateria)

Limpar cache offline

Requer v11.3+

Aciona a ação Limpar do gerenciamento de cache offline.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “cleanup_offline_cache”

Iniciar backup

Requer v11.3+

Inicia um backup com as configurações selecionadas (a senha e pelo menos uma opção devem ser passadas)

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “start_backup”
  • “PASSWORD” [String]: a senha do backup. OBRIGATÓRIO
  • “SETTINGS” [Boolean]: se o backup deve conter este item.
  • “PROVIDERS” [Boolean]: se o backup deve conter este item.
  • “EQ_PROFILES” [Boolean]: se o backup deve conter este item.
  • “INTERNET_RADIO” [Boolean]: se o backup deve conter este item.
  • “PLAYLISTS” [Boolean]: se o backup deve conter este item.
  • “AUTO_OFFLINE_RULES” [Boolean]: se o backup deve conter este item.
  • “USER_DATA” [Boolean]: se o backup deve conter este item.
  • “USER_DATA_ALL” [Boolean]: se o backup deve conter todos os dados do usuário (também requer que dados do usuário esteja ativado)
  • “CUSTOM_IMAGES” [Boolean]: se o backup deve conter este item.
  • “FILE_FAVORITES” [Boolean]: se o backup deve conter este item.
  • “TAG_CACHE” [Boolean]: se o backup deve conter este item.

Alterar conexão ativa do provedor

Requer v13.4+

Força um provedor a usar sua conexão principal ou secundária.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “force_provider_connection”
  • “PROVIDER_ID” [Long]: o ID do provedor. OBRIGATÓRIO
  • “ACTIVE_CONNECTION” [Int]: 1 para conexão principal, 2 para conexão secundária. OBRIGATÓRIO.

Regenerar miniaturas dos artistas

Requer v13.5+

Atualiza a miniatura do artista com base nas miniaturas das músicas que ela contém.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “generate_artist_thumbnail”
  • “ONLY_MISSING_THUMBNAIL” [Boolean]: quando true, atualiza apenas artistas sem uma miniatura já definida.
  • “NAME” [String]: o nome do artista (Observação: você pode usar o valor especial “--ALL--” para regenerar as miniaturas de todos os artistas; fique atento à duração e ao uso de bateria)

Carregar estilo do aplicativo

Requer v13.6+

Carrega um estilo personalizado salvo do aplicativo.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “load_app_style”
  • “NAME” [String]: o nome do estilo do aplicativo

Carregar perfil

Requer v13.6+

Carrega um perfil salvo.

• Ação API: “app.symfonium.api.CUSTOM_ACTION”
• Extras :
  • “ACTION” [String]: “load_profile”
  • “NAME” [String]: o nome do perfil

Voltar ao Wiki