matrix-spec-proposals/data/event-schemas/schema/m.room.message$m.audio.yaml

---
allOf:
  - $ref: core-event-schema/room_event.yaml
description: This message represents a single audio clip.
properties:
  content:
    properties:
      body:
        description: "A description of the audio e.g. 'Bee Gees - Stayin' Alive', or some kind of content description for accessibility e.g. 'audio attachment'."
        type: string
      info:
        description: Metadata for the audio clip referred to in `url`.
        properties:
          duration:
            description: The duration of the audio in milliseconds.
            type: integer
          mimetype:
            description: The mimetype of the audio e.g. `audio/aac`.
            type: string
          size:
            description: The size of the audio clip in bytes.
            type: integer
        title: AudioInfo
        type: object
      msgtype:
        enum:
          - m.audio
        type: string
      url:
        description: |-
          Required if the file is unencrypted. The URL (typically [MXC URI](/client-server-api/#matrix-content-mxc-uris))
          to the audio clip.          
        type: string
      file:
        description: |-
          Required if the file is encrypted. Information on the encrypted
          file, as specified in
          [End-to-end encryption](/client-server-api/#sending-encrypted-attachments).          
        title: EncryptedFile
        type: object
    required:
      - msgtype
      - body
    type: object
  type:
    enum:
      - m.room.message
    type: string
title: AudioMessage
type: object