app.gainforest.ac.audio

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An audio recording record with technical metadata and optional links to occurrence, deployment, and site records.",
      "key": "tid",
      "record": {
        "properties": {
          "accessUri": {
            "description": "URI to the original full-resolution audio resource (e.g. object storage URL). When present, the PDS blob is a compressed variant and this points to the archival original. Aligns with AC ac:accessURI.",
            "format": "uri",
            "maxGraphemes": 2048,
            "type": "string"
          },
          "blob": {
            "description": "The audio file blob stored on the PDS. May be a compressed preview variant when the archival original is referenced via accessUri. At least one of blob or accessUri should be present.",
            "ref": "app.gainforest.common.defs#audio",
            "type": "ref"
          },
          "createdAt": {
            "description": "Timestamp of record creation in the ATProto PDS.",
            "format": "datetime",
            "type": "string"
          },
          "deploymentRef": {
            "description": "AT-URI of the ac.deployment record describing the recording device setup (device model, gain, location, schedule, etc.).",
            "format": "at-uri",
            "type": "string"
          },
          "description": {
            "description": "A longer human-readable description of the audio recording content.",
            "ref": "app.gainforest.common.defs#richtext",
            "type": "ref"
          },
          "license": {
            "description": "License for this recording (e.g., CC-BY-4.0, CC0-1.0). Aligns with AC dcterms:rights.",
            "maxGraphemes": 256,
            "type": "string"
          },
          "metadata": {
            "description": "Technical audio metadata (codec, sample rate, duration, frequency bounds, etc.).",
            "ref": "#metadata",
            "type": "ref"
          },
          "name": {
            "description": "A short human-readable name or label for this audio recording.",
            "maxGraphemes": 256,
            "type": "string"
          },
          "occurrenceRef": {
            "description": "AT-URI of the dwc.occurrence record this audio is evidence for. Use when this recording documents a specific species detection or biodiversity observation.",
            "format": "at-uri",
            "type": "string"
          },
          "recordedBy": {
            "description": "Name of the person or agent who made the recording. Aligns with AC dc:creator. For automated deployments, this is the person who deployed the device.",
            "maxGraphemes": 512,
            "type": "string"
          },
          "siteRef": {
            "description": "AT-URI of the organization site record where this audio was captured.",
            "format": "at-uri",
            "type": "string"
          },
          "spectrogram": {
            "description": "Spectrogram image of the recording (visual frequency-time representation).",
            "ref": "app.gainforest.common.defs#spectrogram",
            "type": "ref"
          },
          "tags": {
            "description": "Freeform tags for the recording (e.g., 'dawn-chorus', 'rain', 'chainsaw', 'anthropogenic-noise'). Aligns with AC ac:tag.",
            "items": {
              "maxGraphemes": 64,
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "thumbnail": {
            "description": "Thumbnail image for display in list views.",
            "ref": "app.gainforest.common.defs#imageThumbnail",
            "type": "ref"
          },
          "variantLiteral": {
            "description": "AC variant describing the quality/size of the PDS blob relative to the archival original. Aligns with AC ac:variant.",
            "knownValues": [
              "Thumbnail",
              "Lower Quality",
              "Medium Quality",
              "Good Quality",
              "Best Quality",
              "Offline"
            ],
            "maxGraphemes": 64,
            "type": "string"
          }
        },
        "required": [
          "metadata",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "metadata": {
      "description": "Technical audio metadata. These are properties of the audio file itself, not the recording context (location, weather, device). Aligns with AC Resource Creation Vocabulary and Music Ontology terms.",
      "properties": {
        "bitDepth": {
          "description": "Bits per sample (e.g., 16, 24, 32).",
          "maximum": 64,
          "minimum": 8,
          "type": "integer"
        },
        "channels": {
          "description": "Number of audio channels (1 = mono, 2 = stereo).",
          "minimum": 1,
          "type": "integer"
        },
        "codec": {
          "description": "Audio codec (e.g., 'PCM', 'FLAC', 'MP3', 'AAC').",
          "maxGraphemes": 32,
          "type": "string"
        },
        "duration": {
          "description": "Duration of the recording in seconds (e.g., '300.0').",
          "maxGraphemes": 32,
          "type": "string"
        },
        "fileFormat": {
          "description": "File format (e.g., 'WAV', 'FLAC', 'MP3'). Aligns with AC dc:format.",
          "maxGraphemes": 32,
          "type": "string"
        },
        "fileSizeBytes": {
          "description": "File size in bytes.",
          "minimum": 0,
          "type": "integer"
        },
        "filterHighPassHz": {
          "description": "High-pass filter cutoff frequency in Hz applied during or after recording. Aligns with AC ac:filterHighPass.",
          "minimum": 0,
          "type": "integer"
        },
        "filterLowPassHz": {
          "description": "Low-pass filter cutoff frequency in Hz applied during or after recording. Aligns with AC ac:filterLowPass.",
          "minimum": 0,
          "type": "integer"
        },
        "maxFrequencyHz": {
          "description": "Highest frequency present in the recording in Hz. Aligns with AC ac:freqHigh.",
          "minimum": 0,
          "type": "integer"
        },
        "minFrequencyHz": {
          "description": "Lowest frequency present in the recording in Hz. Aligns with AC ac:freqLow.",
          "minimum": 0,
          "type": "integer"
        },
        "recordedAt": {
          "description": "Date and time the audio was captured (start of recording). Aligns with AC xmp:CreateDate.",
          "format": "datetime",
          "type": "string"
        },
        "sampleRate": {
          "description": "Sample rate in Hz (e.g., 44100, 48000, 384000 for ultrasonic). Aligns with AC mo:sample_rate.",
          "minimum": 1,
          "type": "integer"
        },
        "signalToNoiseRatio": {
          "description": "Signal-to-noise ratio in dB.",
          "maxGraphemes": 32,
          "type": "string"
        }
      },
      "required": [
        "channels",
        "duration",
        "sampleRate",
        "recordedAt"
      ],
      "type": "object"
    }
  },
  "description": "Generic audio resource record aligned with the TDWG Audiovisual Core standard (http://www.tdwg.org/standards/638). Represents a single audio recording (field recording, soundscape, species call) with its technical metadata. Links to a dwc.occurrence as evidence and optionally to an ac.deployment describing the recording device setup. Does not carry location, weather, habitat, or device fields — those belong on dwc.event, dwc.occurrence, or ac.deployment respectively.",
  "id": "app.gainforest.ac.audio",
  "lexicon": 1
}