Inkommande metadata

Artikel
01/22/2024

Varning

Azure Media Services dras tillbaka den 30 juni 2024. Mer information finns i AMS-pensionsguiden.

Ett kodningsjobb är associerat med en indatatillgång (eller tillgångar) där du vill utföra vissa kodningsuppgifter. När en aktivitet har slutförts skapas en utdatatillgång. Utdatatillgången innehåller video, ljud, miniatyrbilder, manifest och andra filer.

Utdatatillgången innehåller också en fil med metadata om indatatillgången. Namnet på JSON-metadatafilen har ett slumpmässigt ID. Använd det inte för att identifiera den indatatillgång som utdatatillgången tillhör. Om du vill identifiera den indatatillgång som den tillhör använder du fältet Uri (mer information finns i Andra underordnade element).

Media Services söker inte automatiskt igenom indatatillgångar för att generera metadata. Indatametadata genereras endast som en artefakt när en indatatillgång bearbetas i ett jobb. Därför skrivs den här artefakten till utdatatillgången. Olika verktyg används för att generera metadata för indatatillgångar och utdatatillgångar. Därför har indatametadata ett något annorlunda schema än utdatametadata.

I den här artikeln beskrivs de element och typer av JSON-schemat som metada för indata (<asset_id>_metadata.json ) baseras på. Information om filen som innehåller metadata om utdatatillgången finns i Utdatametadata.

Du hittar JSON-schemaexemplet i slutet av den här artikeln.

Anteckning

All tid baseras på FORMATET ISO-8601. Mer information om varaktighetsformatering finns i Tider och varaktigheter i samma artikel.

AssetFile

Innehåller en samling AssetFile-element för kodningsjobbet.

Anteckning

Följande fyra underordnade element måste visas i en sekvens.

Name	Beskrivning
VideoTracks	Varje fysisk tillgångsfil kan innehålla noll eller flera videor som spåras i lämpligt containerformat. Mer information finns i VideoTracks.
AudioTracks	Varje fysisk tillgångsfil kan innehålla noll eller flera ljudspår som interfolierats till ett lämpligt containerformat. Mer information finns i AudioTracks
Metadata	Tillgångsfilens metadata representeras som nyckel/värde-strängar. Exempelvis: `<Metadata key="language" value="eng" />`

Andra underordnade element

Name	Beskrivning
Namn Obligatorisk	Namn på tillgångsfil. Exempel: `"Name": "Ignite-short.mp4"`
Uri Obligatorisk	Url:en där indatatillgången finns. Om du vill identifiera den indatatillgång som utdatatillgången tillhör använder du fältet `Uri` i stället för ID.
Storlek Obligatorisk	Storleken på tillgångsfilen i byte. Exempel: `"Size": 75739259`
Varaktighet Obligatorisk	Varaktighet för uppspelning av innehåll. Exempel: `"Duration": "PT1M10.304S"`.
NumberOfStreams Obligatorisk	Antal strömmar i tillgångsfilen. Exempel: `"NumberOfStreams": 2`
FormatNames Obligatorisk	Formatera namn. Exempel: `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName Obligatorisk	Formatera utförliga namn. Exempel: `"FormatVerboseName": "QuickTime / MOV"`
Starttime	Starttid för innehåll. Exempel: `"StartTime": "PT0S"`
OverallBitRate	Genomsnittlig bithastighet för tillgångsfilen i bitar per sekund. Exempel: `"OverallBitRate": 8618539`

VideoTracks

Name	Beskrivning
Fourcc Obligatorisk	Video codec FourCC-kod som rapporteras av ffmpeg. Exempel: `"FourCC": "avc1" \| "hev1" \| "hvc1"`
Profil	Videospårets profil. Exempel: `"Profile": "Main"`
Nivå	Videospårets nivå. Exempel: `"Level": "3.2"`
PixelFormat	Videospårets pixelformat. Exempel: `"PixelFormat": "yuv420p"`
Bredd Obligatorisk	Kodad videobredd i bildpunkter. Exempel: `"Width": "1280"`
Höjd Obligatorisk	Kodad videohöjd i bildpunkter. Exempel: `"Height": "720"`
DisplayAspectRatioNumerator Obligatorisk	Täljare för videovisningsproportion. Exempel: `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator Obligatorisk	Nämnare för videovisningsproportion. Exempel: `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	Videoexempel på täljare för proportioner. Exempel: `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	Exempel: `"SampleAspectRatioDenominator": 1.0`
Framerate Obligatorisk	Uppmätt videobildfrekvens i .3f-format. Exempel: `"FrameRate": 29.970`
Bitrate	Genomsnittlig videobithastighet i bitar per sekund, beräknat från tillgångsfilen. Endast den elementära strömnyttolasten räknas och paketeringskostnaderna ingår inte. Exempel: `"Bitrate": 8421583`
HasBFrames	Videospår antal B-bildrutor. Exempel: `"HasBFrames": 2`
Metadata	Allmänna nyckel-/värdesträngar som kan användas för att lagra en mängd olika informationssträngar. Se det fullständiga exemplet i slutet av artikeln.
Id Obligatorisk	Nollbaserat index för det här ljud- eller videospåret. Detta ID är inte nödvändigtvis TrackID som används i en MP4-fil. Exempel: `"Id": 2`
Codec	Video spåra codec-sträng. Exempel: `"Codec": "h264 \| hev1"`
CodecLongName	Långt namn på ljud- eller videospårningskod. Exempel: `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	Video spåra codec-sträng. Exempel: `"Codec": "h264 \| hev1"`
TimeBase Obligatorisk	Tidsbas. Exempel: `"TimeBase": "1/30000"`
NumberOfFrames	Antal bildrutor (finns för videospår). Exempel: `"NumberOfFrames": 2107`
Starttime	Spåra starttid. Exempel: `"StartTime": "PT0.033S"`
Varaktighet	Spåra varaktighet. Exempel: `"Duration": "PT1M10.304S"`

AudioTracks

Name	Beskrivning
SampleFormat	Exempelformat. Exempel: `"SampleFormat": "fltp"`
ChannelLayout	Kanallayout. Exempel: `"ChannelLayout": "stereo"`
Kanaler Obligatorisk	Antal (0 eller fler) ljudkanaler. Exempel: `"Channels": 2`
SamplingRate Obligatorisk	Ljudsamplingshastighet i exempel/sek eller Hz. Exempel: `"SamplingRate": 48000`
Bitrate	Genomsnittlig ljudbithastighet i bitar per sekund, beräknat från tillgångsfilen. Endast nyttolasten för den elementära dataströmmen räknas och paketeringskostnaderna ingår inte i det här antalet. Exempel: `"Bitrate": 192080`
Metadata	Allmänna nyckel-/värdesträngar som kan användas för att lagra en mängd olika informationssträngar. Se det fullständiga exemplet i slutet av artikeln.
Id Obligatorisk	Nollbaserat index för det här ljud- eller videospåret. Detta är inte nödvändigtvis att TrackID som används i en MP4-fil. Exempel: `"Id": 1`
Codec	Video spåra codec-sträng. Exempel: `"Codec": "aac"`
CodecLongName	Långt namn på ljud- eller videospårningskod. Exempel: `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase Obligatorisk	Tidsbas. Exempel: `"TimeBase": "1/48000"`
NumberOfFrames	Antal bildrutor (finns för videospår). Exempel: `"NumberOfFrames": 3294`
Starttime	Spåra starttid. Exempel: `"StartTime": "PT0S"`
Varaktighet	Spåra varaktighet. Exempel: `"Duration": "PT1M10.272S"`

Metadata

Name	Beskrivning
Nyckel Obligatorisk	Nyckeln i nyckel/värde-paret.
värde Obligatorisk	Värdet i nyckel/värde-paret.

Schemaexempel

{
  "AssetFile": [
    {
      "VideoTracks": [
        {
          "FourCC": "avc1",
          "Profile": "Main",
          "Level": "3.2",
          "PixelFormat": "yuv420p",
          "Width": "1280",
          "Height": "720",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "SampleAspectRatioNumerator": 1.0,
          "SampleAspectRatioNumeratorSpecified": true,
          "SampleAspectRatioDenominator": 1.0,
          "SampleAspectRatioDenominatorSpecified": true,
          "FrameRate": 29.970,
          "Bitrate": 8421583,
          "BitrateSpecified": true,
          "HasBFrames": 2,
          "HasBFramesSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Video Media Handler"
            },
            {
              "key": "encoder",
              "value": "AVC Coding"
            }
          ],
          "Id": 2,
          "Codec": "h264",
          "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "TimeBase": "1/30000",
          "NumberOfFrames": 2107,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0.033S",
          "Duration": "PT1M10.304S"
        }
      ],
      "AudioTracks": [
        {
          "SampleFormat": "fltp",
          "ChannelLayout": "stereo",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 192080,
          "BitrateSpecified": true,
          "BitsPerSampleSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Sound Media Handler"
            }
          ],
          "Id": 1,
          "Codec": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "TimeBase": "1/48000",
          "NumberOfFrames": 3294,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0S",
          "Duration": "PT1M10.272S"
        }
      ],
      "Metadata": [
        {
          "key": "major_brand",
          "value": "mp42"
        },
        {
          "key": "minor_version",
          "value": "19529854"
        },
        {
          "key": "compatible_brands",
          "value": "mp42isom"
        },
        {
          "key": "creation_time",
          "value": "2018-02-21T21:42:08.000000Z"
        }
      ],
      "Name": "Ignite-short.mp4",
      "Uri": "https://amsstorageacct.blob.core.windows.net/asset-00000000-0000-0000-000000000000/ignite.mp4",
      "Size": 75739259,
      "Duration": "PT1M10.304S",
      "NumberOfStreams": 2,
      "FormatNames": "mov,mp4,m4a,3gp,3g2,mj2",
      "FormatVerboseName": "QuickTime / MOV",
      "StartTime": "PT0S",
      "OverallBitRate": 8618539,
      "OverallBitRateSpecified": true
    }
  ]
}

Få hjälp och support

Du kan kontakta Media Services med frågor eller följa våra uppdateringar med någon av följande metoder:

Q & A
Stack Overflow. Tagga frågor med azure-media-services.
@MSFTAzureMedia eller använd @AzureSupport för att begära support.
Öppna en supportbegäran via Azure Portal.

Dela via