モバイルアプリのみ。カスタムサウンドはWebプッシュではサポートされていません。
セットアップ
サウンドファイルを作成する
次のルールに従ってサウンドファイルを作成してください。デバイスが問題のファイルを見つけられない場合、またはファイルがサポートされている形式でない場合は、デフォルトのシステム通知サウンドにフォールバックします。一部のプラットフォームはサウンドファイルの大文字を無視するため、サウンドファイル名は小文字にしてください。
AwesomeSound.wavの代わりにawesomesound.wavまたはawesome_sound.wavを使用してください。| プラットフォーム | 拡張子 | 注意事項 |
|---|---|---|
| iOS | .wav .aiff .caf | サウンドはLinear PCM、MA4（IMA/ADPCM）、µLaw、またはaLawでエンコードする必要があります。30秒未満である必要があります。 |
| Android | .wav .mp3 .ogg | 推奨される長さは30秒未満です。ファイルサイズを小さく保ち、大きなファイルは一部のデバイスで再生されない場合があります。 |
| Huawei | .wav .mp3 .wma | 推奨される長さは30秒未満です。ファイルサイズを小さく保ち、大きなファイルは一部のデバイスで再生されない場合があります。 |
| Amazon | .wav .mp3 .ogg | 推奨される長さは30秒未満です。ファイルサイズを小さく保ち、大きなファイルは一部のデバイスで再生されない場合があります。 |
アプリにサウンドファイルを追加する
通知にサウンドを追加するには、アプリ内のリソースとしてサウンドファイルを含める必要があります。外部URLはサポートされていません。- iOS
- Android、Huawei、Amazon
SDKに応じて、Xcodeプロジェクトの適切な場所にサウンドファイルを追加します。
| SDK | フォルダー |
|---|---|
| iOS Native | Xcodeプロジェクトルートにファイルを追加します。ファイルを追加する際にAdd to targetsが選択されていることを確認して、バンドルリソースに自動的に追加されるようにします。 |
| Cordova, Ionic | <project-root>/platforms/ios/project-name.xcodeproj内のXcodeプロジェクトのResourcesディレクトリにファイルを追加します。 |
| Unity | Unityプロジェクト内の任意の場所にサウンドを追加し、プロジェクトをビルドしてから、それらのサウンドをXcodeプロジェクトルートに移動します。 |
通知を送信する
- iOS
- Android、Huawei、Amazon
- REST API
サウンドリソースを参照する際には、ファイル拡張子を追加します。たとえば、
explode_sound.wavです。プッシュメッセージを送信する際にダッシュボードで設定するか、Create Notification APIのios_soundプロパティを使用します。サウンドなしの場合は、Soundフィールドにnilを渡します。アプリにサウンドリソースを最近追加した場合は、サウンドを使用して通知を送信する前に数日待つことをお勧めします。これは、ユーザーの大部分が新しいサウンドリソースを含む最新バージョンにアプリを更新するのに数日または数週間かかる可能性があるためです。サウンドリソースのない古いバージョンのアプリを持つユーザーがそれを参照する通知を受信した場合、デフォルトのシステム通知サウンドのみが聞こえます。
よくある質問
デフォルトのサウンドを設定できますか？
サウンドやAndroid通知チャネルを参照するテンプレートを使用してください。通知がカスタムサウンドファイルを再生しないのはなぜですか？
サウンドが再生されない理由はいくつかあります。- サウンドファイルのファイル拡張子が正しくない
- サウンドファイルがサポートされている形式でエンコードされていない
- サウンドファイルが正しくない場所にある
- サウンドファイルが長すぎる
res/raw/に配置されていることを確認してください。
リソースの縮小が有効になっている場合は、次のコードでres/raw/にkeep.xmlを作成することで、サウンドファイルが削除されないように保護できます
xml