Apenas para aplicativos móveis. Sons personalizados não são suportados em push web.
Configuração
Criar arquivos de som
Certifique-se de criar arquivos de som de acordo com as seguintes regras. Se o dispositivo não conseguir encontrar o arquivo em questão, ou se o arquivo não estiver em um formato suportado, ele voltará ao som de notificação padrão do sistema.Mantenha os nomes de arquivo de som em minúsculas, pois algumas plataformas ignoram letras maiúsculas para arquivos de som. Em vez de
AwesomeSound.wav, use awesomesound.wav ou awesome_sound.wav.| Plataforma | Extensões | Notas |
|---|---|---|
| iOS | .wav .aiff .caf | Sons devem ser codificados como Linear PCM, MA4 (IMA/ADPCM), µLaw ou aLaw. Devem ter menos de 30 segundos. |
| Android | .wav .mp3 .ogg | Duração recomendada menor que 30 segundos. Mantenha o tamanho do arquivo pequeno, arquivos grandes podem não tocar em alguns dispositivos. |
| Huawei | .wav .mp3 .wma | Duração recomendada menor que 30 segundos. Mantenha o tamanho do arquivo pequeno, arquivos grandes podem não tocar em alguns dispositivos. |
| Amazon | .wav .mp3 .ogg | Duração recomendada menor que 30 segundos. Mantenha o tamanho do arquivo pequeno, arquivos grandes podem não tocar em alguns dispositivos. |
Adicionar arquivos de som ao aplicativo
Para adicionar sons às notificações, você deve incluir os arquivos de som como recursos dentro do seu aplicativo. URLs externas não são suportadas.- iOS
- Android, Huawei, and Amazon
Adicione arquivos de som ao local apropriado no seu projeto Xcode, dependendo do seu SDK.
| SDK | Pasta |
|---|---|
| iOS Native | Adicione arquivos à raiz do projeto Xcode. Certifique-se de que Add to targets esteja selecionado ao adicionar arquivos para que sejam automaticamente adicionados aos recursos do bundle. |
| Cordova, Ionic | Adicione arquivos ao diretório Resources dentro do projeto Xcode em <project-root>/platforms/ios/project-name.xcodeproj. |
| Unity | Adicione sons em qualquer lugar no seu projeto Unity, compile seu projeto e, em seguida, mova esses sons para a raiz do projeto Xcode. |
Enviar notificações
- iOS
- Android, Huawei, and Amazon
- REST API
Adicione a extensão do arquivo ao referenciar o recurso de som. Por exemplo, 
explode_sound.wav. Defina no painel ao enviar mensagens push ou use a propriedade ios_sound da API Create Notification.Para nenhum som, passe nil no campo Sound.Se você adicionou um recurso de som ao seu aplicativo muito recentemente, talvez queira esperar alguns dias antes de enviar notificações usando o som. Isso ocorre porque pode levar muitos dias ou até semanas para a maioria dos seus usuários atualizarem seus aplicativos para a versão mais recente que contém seu novo recurso de som.Se um usuário tiver uma versão mais antiga do seu aplicativo sem o recurso de som e receber uma notificação que o referencia, ele ouvirá apenas o som de notificação padrão do sistema.
FAQ
Posso definir um som padrão?
Use um Template que referencia o som e/ou Canal de Notificação Android.Por que minha notificação não está tocando o arquivo de som personalizado?
Existem algumas razões pelas quais um som pode não tocar.- O arquivo de som tem uma extensão de arquivo incorreta
- O arquivo de som não está codificado em um formato suportado
- O arquivo de som está no local incorreto
- O arquivo de som é muito longo
res/raw/.
Se a redução de recursos estiver habilitada, você pode proteger arquivos de som de serem removidos criando keep.xml em res/raw/ com o seguinte código
xml