-
Notifications
You must be signed in to change notification settings - Fork 369
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Sticker messages (m.sticker) (#1158)
- Loading branch information
Showing
7 changed files
with
133 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
{ | ||
"age": 242352, | ||
"content": { | ||
"body": "Landing", | ||
"info": { | ||
"mimetype": "image/png", | ||
"thumbnail_info": { | ||
"mimetype": "image/png", | ||
"h": 200, | ||
"w": 140, | ||
"size": 73602 | ||
}, | ||
"h": 200, | ||
"thumbnail_url": "mxc://matrix.org/sHhqkFCvSkFwtmvtETOtKnLP", | ||
"w": 140, | ||
"size": 73602 | ||
}, | ||
"url": "mxc://matrix.org/sHhqkFCvSkFwtmvtETOtKnLP" | ||
}, | ||
"origin_server_ts": 1431961217939, | ||
"event_id": "$WLGTSEFSEF:localhost", | ||
"type": "m.sticker", | ||
"room_id": "!Cuyf34gef24t:localhost", | ||
"sender": "@example:localhost" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
--- | ||
allOf: | ||
- $ref: core-event-schema/room_event.yaml | ||
description: This message represents a single sticker image. | ||
properties: | ||
content: | ||
properties: | ||
body: | ||
description: |- | ||
A textual representation or associated description of the sticker | ||
image. This could be the alt text of the original image, or a message | ||
to accompany and further describe the sticker. | ||
type: string | ||
info: | ||
allOf: | ||
- $ref: core-event-schema/msgtype_infos/image_info.yaml | ||
description: |- | ||
Metadata about the image referred to in ``url`` including a thumbnail | ||
representation. | ||
url: | ||
description: |- | ||
The URL to the sticker image. This must be a valid ``mxc://`` URI. | ||
type: string | ||
required: | ||
- body | ||
- info | ||
- url | ||
type: object | ||
type: | ||
enum: | ||
- m.sticker | ||
type: string | ||
title: StickerMessage | ||
type: object |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
.. Copyright 2018 New Vector Ltd. | ||
.. | ||
.. Licensed under the Apache License, Version 2.0 (the "License"); | ||
.. you may not use this file except in compliance with the License. | ||
.. You may obtain a copy of the License at | ||
.. | ||
.. http://www.apache.org/licenses/LICENSE-2.0 | ||
.. | ||
.. Unless required by applicable law or agreed to in writing, software | ||
.. distributed under the License is distributed on an "AS IS" BASIS, | ||
.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
.. See the License for the specific language governing permissions and | ||
.. limitations under the License. | ||
Sticker Messages | ||
================ | ||
|
||
.. _module:stickers: | ||
|
||
This module allows users to send sticker messages in to rooms or direct | ||
messaging sessions. | ||
|
||
Sticker messages are specialised image messages that are displayed without | ||
controls (e.g. no "download" link, or light-box view on click, as would be | ||
displayed for for `m.image`_ events). | ||
|
||
Sticker messages are intended to provide simple "reaction" events in the message | ||
timeline. The matrix client should provide some mechanism to display the sticker | ||
"body" e.g. as a tooltip on hover, or in a modal when the sticker image is | ||
clicked. | ||
|
||
Events | ||
------ | ||
Sticker events are received as a single ``m.sticker`` event in the | ||
``timeline`` section of a room, in a ``/sync``. | ||
|
||
{{m_sticker_event}} | ||
|
||
Client behaviour | ||
---------------- | ||
|
||
Clients supporting this message type should display the image content from the | ||
event URL directly in the timeline. | ||
|
||
A thumbnail image should be provided in the ``info`` object. This is | ||
largely intended as a fallback for clients that do not fully support the | ||
``m.sticker`` event type. In most cases it is fine to set the thumbnail URL to the | ||
same URL as the main event content. | ||
|
||
It is recommended that sticker image content should be 512x512 pixels in size | ||
or smaller. The dimensions of the image file should be twice the intended | ||
display size specified in the ``info`` object in order to assist | ||
rendering sharp images on higher DPI screens. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters