iTunes file sharing change and file format (#8395)

* iTunes file sahering change and file format

Updated the procedure to reflect the menu structure in the latest version of iTunes and added file format required.

* ✏️ Tweaks
This commit is contained in:
tomlut 2019-02-15 05:19:56 +11:00 committed by Franck Nijhof
parent 95204f0dd6
commit eb70e25b67

View File

@ -31,23 +31,24 @@ Notes:
* You must use the full filename in the payload (including extension). * You must use the full filename in the payload (including extension).
## {% linkable_title Custom push notification sounds %} ## {% linkable_title Custom push notification sounds %}
The app allows you to use your own custom sounds in push notifications. The sounds must be formatted following [Apple's requirements][sound-requirements]. You set the filename of the sound in the notification payload. To add sounds:
The app allows you to use your own custom sounds in push notifications. The sounds must be formatted as 32bit float 48000Hz wav files. You set the filename of the sound in the notification payload. To add sounds:
1. Connect the device to a PC or Mac running the latest version of iTunes. 1. Connect the device to a PC or Mac running the latest version of iTunes.
2. Go to the device in iTunes. 2. Go to the device in iTunes.
3. Select "Apps" on the left sidebar. 3. Select "File Sharing" in the left-hand menu.
4. Scroll down until you see the section labeled "File Sharing". 4. Select Home Assistant.
5. Select Home Assistant. 5. Drag and drop properly formatted sounds (32bit float 48000Hz wav files).
6. Drag and drop properly formatted sounds. 6. Click Sync in the lower right.
7. Click Sync in the lower right. 7. Once the sync is complete, disconnect the device from the computer.
8. Once sync is complete, disconnect the device from the computer. 8. On your iOS device, open the Home Assistant app.
9. On your iOS device, open the Home Assistant app. 9. Go to Settings -> Notification Settings.
10. Go to Settings -> Notification Settings. 10. Select "Import sounds from iTunes".
11. Select "Import sounds from iTunes".
Assuming that you correctly formatted the sounds they are now available to use in push notifications. Assuming that you correctly formatted the sounds they are now available to use in push notifications.
Notes: Notes:
* **Please note that due to a bug in iOS 10 you may need to restart your entire device before notification sounds can be played. This should hopefully be fixed by Apple soon.** * **Please note that due to a bug in iOS 10 you may need to restart your entire device before notification sounds can be played. This should hopefully be fixed by Apple soon.**
* Uploading a file with the same name as an existing one will overwrite the original. * Uploading a file with the same name as an existing one will overwrite the original.
* You can view what sounds are installed on each device by inspecting the `ios.conf` file in your configuration directory. They are listed in the `pushSounds` array. * You can view what sounds are installed on each device by inspecting the `ios.conf` file in your configuration directory. They are listed in the `pushSounds` array.