Checkpoint. Mostly done.

2016-10-26 17:38:58 -07:00 · 2016-10-26 17:38:58 -07:00 · f3fd512485
commit f3fd512485
parent 317a241460
33 changed files with 687 additions and 10 deletions
--- a/source/_ecosystem/ios/notifications/attachments.markdown
+++ b/source/_ecosystem/ios/notifications/attachments.markdown
@ -0,0 +1,69 @@
+---
+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
+---
+
+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://67.media.tumblr.com/ab04c028a5244377a0ab96e73915e584/tumblr_nfn3ztLjxk1tq4of6o1_400.gif
+            content-type: gif
+            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
+
+![Attachment](/images/ios/attachment.png)
+![Expanded Attachment](/images/ios/expanded_attachment.png)
+
+## 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.