mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-04 09:16:49 +00:00
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
---
|
|
layout: page
|
|
title: "Notification attachments"
|
|
description: "Adding attachments to iOS push notifications"
|
|
date: 2016-10-25 15:00:00 -0700
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
redirect_from: /ecosystem/ios/notifications/attachments/
|
|
---
|
|
|
|
iOS 10 adds _attachments_ to notifications. An attachment is an image, video, or audio file which is downloaded to the device when a notification is received and shown alongside the notification. A thumbnail is shown when the notification is not expanded. The full size attachment is shown when the notification is expanded.
|
|
|
|
<p class="note">
|
|
To expand a notification on 3D Touch devices simply force touch any notification. On non-3D Touch devices swipe and tap the "View" button.
|
|
</p>
|
|
|
|
```yaml
|
|
- alias: Notify iOS app
|
|
trigger:
|
|
...
|
|
action:
|
|
service: notify.ios_robbies_iphone_7_plus
|
|
data:
|
|
message: "Something happened at home!"
|
|
data:
|
|
attachment:
|
|
url: "https://github.com/home-assistant/home-assistant-assets/blob/master/logo-round-192x192.png?raw=true"
|
|
content-type: png
|
|
hide-thumbnail: false
|
|
```
|
|
|
|
Notes:
|
|
* The thumbnail of the notification will be the media at the `url`.
|
|
* The notification content is the media at the `url`.
|
|
* Attachment can be used with custom push notification categories.
|
|
|
|
## Example
|
|
|
|
<p class='img'>
|
|
<img src='/images/ios/attachment.png' />
|
|
An unexpanded push notification with an attachment.
|
|
</p>
|
|
|
|
<p class='img'>
|
|
<img src='/images/ios/expanded_attachment.png' />
|
|
The same notification but expanded to show the full size attachment
|
|
</p>
|
|
|
|
## Supported media types
|
|
|
|
If the attachment does not appear please ensure it is in one of the following formats:
|
|
|
|
### Audio attachments
|
|
|
|
Maximum file size: 5 MB
|
|
|
|
Allowed Formats: AIFF, WAV, MP3, MPEG4 Audio
|
|
|
|
### Image attachments
|
|
|
|
Maximum file size: 10 MB
|
|
|
|
Allowed Formats: JPEG, GIF, PNG
|
|
|
|
### Video attachments
|
|
|
|
Maximum file size: 50 MB
|
|
|
|
Allowed Formats: MPEG, MPEG2, MPEG4, AVI
|
|
|
|
## Configuration
|
|
|
|
- **url** (*Required*): The URL of content to use as the attachment. This URL _must_ be accessible from the Internet, or the receiving device must be on the same network as the hosted content.
|
|
- **content-type** (*Optional*): By default, the extension of the URL will be checked to determine the filetype. If there is no extension/it can't be determined you can manually provide a file extension.
|
|
- **hide-thumbnail** (*Optional*): If set to `true` the thumbnail will not show on the notification. The content will only be viewable by expanding.
|