Referensi XML
Halaman ini membahas struktur XML dan contoh kode untuk impor DDEX LabelGrid. Untuk persyaratan metadata, peran kontributor, pembagian, dan standar pemformatan, lihat Metadata rilis, Metadata lagu, dan Validasi.
ERN 4.3.2 adalah versi impor yang disarankan untuk integrasi baru. Lihat ERN 4.3.2 di bawah untuk elemen akarnya, field deklarasi AI yang ditambahkannya, dan contoh 4.3.2 lengkap dengan setiap field. Sebagian besar contoh rinci pada halaman ini menggunakan format ERN 4.3; struktur pesannya sama pada 4.3.1/4.3.2, sehingga berlaku untuk ketiganya (ganti namespace akar dan terapkan perubahan field 4.3.2, yaitu DisplayGenre, bentuk Role kompleks, dan elemen AI). Nilai PartyReference pada keluaran sebenarnya adalah pengidentifikasi yang di-hash MD5 (mis. P8A1B2C3D4E5F6...). Contoh di bawah ini menggunakan nama yang mudah dibaca demi kejelasan.
Struktur pesan ERN 4.3
Section titled “Struktur pesan ERN 4.3”Setiap pengiriman DDEX adalah dokumen XML NewReleaseMessage dengan lima bagian utama:
NewReleaseMessage├── MessageHeader — Sender, recipient, and message ID├── PartyList — All artists, contributors, and rights holders├── ResourceList — Audio files and artwork with technical details├── ReleaseList — The album/single release and individual tracks└── DealList — Commercial terms, territories, and datesElemen akar mencakup namespace ERN 4.3 dan lokasi skema:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/43" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/43 http://ddex.net/xml/ern/43/release-notification.xsd" AvsVersionId="3" LanguageAndScriptCode="en">| Atribut | Deskripsi |
|---|---|
xmlns:ern | URI namespace ERN 4.3 |
xsi:schemaLocation | Skema untuk validasi |
AvsVersionId | Versi himpunan nilai yang diperbolehkan |
LanguageAndScriptCode | Bahasa default pesan |
ERN 4.3.2
Section titled “ERN 4.3.2”ERN 4.3.2 adalah versi impor yang disarankan untuk integrasi LabelGrid baru. Ini adalah revisi yang lebih baru dari keluarga ERN 4.3 dan sepenuhnya didukung oleh importer LabelGrid. Versi ini menggunakan namespace dan skema yang berbeda dari 4.3, sehingga keduanya tidak dapat dipertukarkan pada tingkat XML; elemen akar saja yang menentukan versinya. Jika sistem Anda dapat menghasilkan keduanya, buatlah 4.3.2.
Elemen akar
Section titled “Elemen akar”<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/432" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/432 http://ddex.net/xml/ern/432/release-notification.xsd" AvsVersionId="4" LanguageAndScriptCode="en">| Atribut | ERN 4.3 | ERN 4.3.2 |
|---|---|---|
xmlns:ern | http://ddex.net/xml/ern/43 | http://ddex.net/xml/ern/432 |
xsi:schemaLocation | …/ern/43 …/ern/43/release-notification.xsd | …/ern/432 …/ern/432/release-notification.xsd |
AvsVersionId | 3 | 4 |
Skema release-notification 4.3.2 publik berada di http://service.ddex.net/xml/ern/432/release-notification.xsd (padanan 4.3-nya adalah http://service.ddex.net/xml/ern/43/release-notification.xsd). Anda dapat memvalidasi salah satu berkas terhadap skemanya dengan validator daring DDEX.
Apa yang berubah antara 4.3, 4.3.1, dan 4.3.2 {#what-changes-between-43-431-and-432}
Section titled “Apa yang berubah antara 4.3, 4.3.1, dan 4.3.2 {#what-changes-between-43-431-and-432}”Badan pesannya memiliki bentuk yang sama dengan contoh 4.3 di bawah: bagian MessageHeader, PartyList, ResourceList, ReleaseList, dan DealList mempertahankan struktur yang sama. Perbedaannya hanya segelintir perubahan pada tingkat elemen yang diperkenalkan di ERN 4.3.1 dan dibawa tanpa perubahan ke 4.3.2. Jika Anda beralih dari 4.3 (4.3.0), inilah tiga hal yang perlu diubah:
| Area | ERN 4.3 (4.3.0) | ERN 4.3.1 dan 4.3.2 |
|---|---|---|
| Elemen genre | <Genre> | <DisplayGenre>, dengan anak GenreText + SubGenre yang sama, hanya diganti namanya |
| Peran kontributor | Sederhana: <Role>StudioProducer</Role> | Kompleks: <Role><Value>StudioProducer</Value></Role> |
| Atribusi AI | (tidak tersedia) | Elemen baru <ContainsAI>, <AiContribution>, dan <SpecialContributor> |
Selebihnya (MessageHeader, parties, deals, penempatan ISRC/ISWC, detail teknis audio/artwork, judul, P-Line/C-Line, deals, tanggal) identik dengan contoh 4.3 di bagian lain halaman ini. Satu-satunya bagian yang spesifik per versi adalah ketiga hal di atas; field deklarasi AI mendapat bagiannya sendiri berikutnya karena itulah alasan utama menggunakan 4.3.2.
Field deklarasi AI (4.3.2) {#ai-declaration-fields-432}
Section titled “Field deklarasi AI (4.3.2) {#ai-declaration-fields-432}”Inilah bagian dari 4.3.2 yang tidak ada di 4.3 biasa. Ada tiga elemen, dan semuanya mendeskripsikan pengungkapan dasar yang sama: seberapa banyak konten yang dihasilkan oleh AI. Setiap nilai adalah salah satu dari None, Partly, atau All; tidak ada flag boolean dan tidak ada field teks bebas.
Tempat setiap elemen ditaruh
Section titled “Tempat setiap elemen ditaruh”| Elemen | Muncul pada | Posisi | Nilai |
|---|---|---|---|
<ContainsAI> | setiap <SoundRecording> (lagu) | Setelah <ParentalWarningType>, sebelum <LanguageOfPerformance> | None / Partly / All |
<ContainsAI> | <Release> utama | Setelah blok <ResourceGroup> | None / Partly / All; nilai tertinggi di seluruh lagu dan artwork |
<ContainsAI> | <Image> sampul | Setelah <ResourceId>, sebelum <TechnicalDetails> | None / Partly / All |
<AiContribution> | setiap <Contributor> | Setelah <Role> | None / Partly / All |
<SpecialContributor> | sebuah <Contributor> yang sepenuhnya AI | Menggantikan <ContributorPartyReference> (saling eksklusif) | Nilai tetap GenerativeAI |
Bagaimana nilainya ditentukan
Section titled “Bagaimana nilainya ditentukan”Formulir lagu memiliki dua menu turun pengungkapan AI (lihat Menambahkan lagu): Generative AI Disclosure (rekaman suara) dan Composition AI Disclosure (lagu). Artwork rilis memiliki pengaturan AI-nya sendiri. Masing-masing memetakan ke nilai DDEX sebagai berikut:
| Pilihan pengungkapan | Nilai DDEX |
|---|---|
| Tidak ada AI generatif yang digunakan | None |
| Hanya bantuan AI ringan | Partly |
| AI menghasilkan sebagian materi | Partly |
| Seluruhnya dihasilkan dengan AI | All |
<ContainsAI>sebuah lagu adalah nilai tertinggi dari pengungkapan Generative AI dan Composition AI-nya.<ContainsAI>rilis adalah nilai tertinggi di seluruh lagu ditambah artwork.<AiContribution>sebuah<Contributor>mencerminkan kredit spesifik tersebut. Kontributor bernama (manusia) dibatasi maksimalPartly; nilaiAllhanya pernah dinyatakan melalui<SpecialContributor>GenerativeAI</SpecialContributor>, yang tidak membawa nama party.
Contoh dalam konteks
Section titled “Contoh dalam konteks”DisplayGenre menggantikan elemen Genre 4.3 (anaknya tidak berubah):
<!-- 4.3.2 uses DisplayGenre; 4.3.0 used Genre --><DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre></DisplayGenre>ContainsAI pada sebuah lagu, di posisinya yang benar:
<SoundRecording> <ResourceReference>A1</ResourceReference> <!-- ... editions, titles, artists, contributors, duration ... --> <ParentalWarningType>NotExplicit</ParentalWarningType> <ContainsAI>Partly</ContainsAI> <LanguageOfPerformance>en</LanguageOfPerformance></SoundRecording>ContainsAI pada gambar sampul (sebelum TechnicalDetails):
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <ContainsAI>None</ContainsAI> <TechnicalDetails> <!-- ... --> </TechnicalDetails></Image>Seorang kontributor yang menggunakan bentuk Role kompleks dengan AiContribution, di samping kontributor yang sepenuhnya AI yang menggunakan SpecialContributor alih-alih referensi party:
<!-- Human contributor: complex Role + per-credit AiContribution --><Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>StudioProducer</Value></Role> <AiContribution>None</AiContribution></Contributor>
<!-- Fully AI-generated credit: SpecialContributor replaces ContributorPartyReference --><Contributor SequenceNumber="2"> <SpecialContributor>GenerativeAI</SpecialContributor> <Role><Value>Vocalist</Value></Role> <AiContribution>All</AiContribution></Contributor>Untuk memastikan sebuah pesan 4.3.2 lolos validasi sebelum pengiriman, periksa pesan tersebut terhadap skema release-notification 4.3.2 publik (http://service.ddex.net/xml/ern/432/release-notification.xsd) dengan validator daring DDEX.
MessageHeader
Section titled “MessageHeader”Mengidentifikasi pengirim (organisasi Anda), penerima (DSP), dan ID pesan yang unik.
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime></MessageHeader>| Elemen | Deskripsi |
|---|---|
MessageThreadId | Mengelompokkan pesan terkait (mis. pembaruan untuk rilis yang sama) |
MessageId | Pengidentifikasi unik untuk pesan spesifik ini |
MessageSender | DDEX Party ID dan nama organisasi Anda |
MessageRecipient | DDEX Party ID dan nama DSP penerima |
MessageCreatedDateTime | Timestamp ISO 8601 saat pesan dibuat |
PartyList
Section titled “PartyList”Semua entitas yang dirujuk di tempat lain dalam XML (label rekaman, artis, kontributor, dan penerbit) didefinisikan di sini. Setiap party mendapat PartyReference yang digunakan untuk menautkannya di seluruh dokumen.
Label rekaman
Section titled “Label rekaman”<Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId></Party>Artis dapat menyertakan pengidentifikasi standar seperti ISNI:
<!-- Primary Artist with ISNI --><Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId></Party>
<!-- Featured Artist (no ISNI) --><Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId></Party>Kontributor
Section titled “Kontributor”Kontributor (penulis lagu, produser, engineer) dapat menyertakan pengidentifikasi IPI:
<!-- Songwriter / Composer / Producer with IPI --><Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId></Party>
<!-- Mixing Engineer (no IPI) --><Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName></Party>Penerbit
Section titled “Penerbit”<Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName></Party>Pengidentifikasi party yang didukung:
| Pengidentifikasi | Elemen | Format |
|---|---|---|
| ISNI | <ISNI> | 16 karakter (15 digit + digit cek) |
| IPI | <IpiNameNumber> | Diisi nol di depan hingga 11 digit |
| Proprietary | <ProprietaryId> | Referensi internal LabelGrid |
ResourceList
Section titled “ResourceList”Berisi semua berkas audio dan artwork. Setiap resource mendapat ResourceReference (mis. A1, A2) yang digunakan untuk menautkannya ke rilis.
Rekaman suara
Section titled “Rekaman suara”<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<!-- ISRC and P-Line inside SoundRecordingEdition --> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine>
<!-- Technical details of the audio file --> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<!-- ISWC goes on parent SoundRecording, NOT inside Edition --> <WorkId> <ISWC>T3351864278</ISWC> </WorkId>
<!-- Track title --> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<!-- Display artist string --> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName>
<!-- Artist roles --> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<!-- Contributors --> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>ComposerLyricist</Role> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <!-- "Producer" display role maps to DDEX role "StudioProducer" --> <Role>StudioProducer</Role> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role>MixingEngineer</Role> </Contributor> <Contributor SequenceNumber="4"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role>MusicPublisher</Role> </Contributor>
<!-- Copyright ownership --> <WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController>
<!-- Duration in ISO 8601 format --> <Duration>PT00H04M32S</Duration>
<!-- Parental warning --> <ParentalWarningType>NotExplicit</ParentalWarningType>
<!-- Language of performance --> <LanguageOfPerformance>en</LanguageOfPerformance></SoundRecording>Poin penting:
ISRCdanPLineberada di dalamSoundRecordingEditionISWCberada padaSoundRecordinginduk melaluiWorkId(bukan di dalam Edition)DisplayTitleTexthanya berisi judul dasar (tanpa versi mix)- Elemen
SubTitledi dalamDisplayTitlemenampung versi mix (kosong jika tidak ada) - Peran tampilan “Producer” memetakan ke peran DDEX
StudioProducer - URI berkas audio mengikuti pola:
resources/{UPC}_{disc}_{track}.{ext}
Sampul
Section titled “Sampul”<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails></Image>ReleaseList
Section titled “ReleaseList”Berisi rilis utama (album atau single) dan rilis lagu individual. Rilis utama menautkan ke resource melalui ResourceGroup.
Rilis utama
Section titled “Rilis utama”<Release> <ReleaseReference>R0</ReleaseReference>
<!-- ReleaseType comes before ReleaseId in ERN 4.3 --> <ReleaseType>Single</ReleaseType>
<ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference>
<PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine>
<Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre>
<OriginalReleaseDate>2025-08-15</OriginalReleaseDate>
<ParentalWarningType>NotExplicit</ParentalWarningType>
<!-- ResourceGroup links tracks and artwork to the release --> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup></Release>Poin penting:
ReleaseTypemuncul sebelumReleaseIddi ERN 4.3- UPC/EAN masuk ke
<ICPN>di dalamReleaseId - Resource ditautkan melalui
ResourceGroup(bukanReleaseResourceReferenceList) ReleaseLabelReferencemengarah kePartyReferencelabel
Rilis lagu
Section titled “Rilis lagu”Setiap lagu juga mendapat TrackRelease-nya sendiri untuk ketersediaan lagu individual di platform:
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference>
<Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre>
<Keywords>electronic deep house chill night</Keywords></TrackRelease>DealList
Section titled “DealList”Mendefinisikan ketentuan komersial saat rilis tersedia. Setiap Deal menentukan wilayah, tanggal mulai, model komersial, dan jenis penggunaan.
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference>
<!-- Subscription streaming (e.g., Spotify Premium) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal>
<!-- Ad-supported streaming (e.g., Spotify Free) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal>
<!-- Pay-per-download (e.g., iTunes) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal>
</ReleaseDeal></DealList>Jenis model komersial:
| Model | Deskripsi | Contoh |
|---|---|---|
SubscriptionModel | Streaming berlangganan berbayar | Spotify Premium, Apple Music |
AdvertisementSupportedModel | Streaming gratis yang didukung iklan | Spotify Free, YouTube |
PayAsYouGoModel | Pembelian bayar-per-unduh | iTunes, Amazon Music |
Contoh
Section titled “Contoh”Rilis single lengkap
Rilis satu lagu yang lengkap dengan satu artis utama, satu artis unggulan, dan kredit kontributor yang lengkap.
Metadata masukan:
| Field | Nilai |
|---|---|
| Judul | Midnight Run |
| Artis | Luna Wave (utama), DJ Koda (unggulan) |
| UPC | 198765432109 |
| Tanggal Rilis | 2025-08-15 |
| Label | Neon Sounds |
| Nomor Katalog | NS-2025-042 |
| Genre | Electronic / Deep House |
| C-Line | 2025 Neon Sounds LLC |
| P-Line | 2025 Neon Sounds LLC |
| ISRC Lagu | USNS12500001 |
| Eksplisit | Not Explicit |
XML yang dihasilkan:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/43" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/43 http://ddex.net/xml/ern/43/release-notification.xsd" AvsVersionId="3" LanguageAndScriptCode="en">
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime> </MessageHeader>
<PartyList> <Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName> </Party> <Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName> </Party> </PartyList>
<ResourceList> <SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition> <WorkId> <ISWC>T3351864278</ISWC> </WorkId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>ComposerLyricist</Role> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>StudioProducer</Role> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role>MixingEngineer</Role> </Contributor> <Contributor SequenceNumber="4"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role>MusicPublisher</Role> </Contributor> <WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController> <Duration>PT00H04M32S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType> <LanguageOfPerformance>en</LanguageOfPerformance> </SoundRecording>
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails> </Image> </ResourceList>
<ReleaseList> <Release> <ReleaseReference>R0</ReleaseReference> <ReleaseType>Single</ReleaseType> <ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine> <Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre> <OriginalReleaseDate>2025-08-15</OriginalReleaseDate> <ParentalWarningType>NotExplicit</ParentalWarningType> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup> </Release>
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre> <Keywords>electronic deep house chill night</Keywords> </TrackRelease> </ReleaseList>
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal> </ReleaseDeal> </DealList>
</NewReleaseMessage>Rilis ERN 4.3.2 lengkap (semua field, dengan deklarasi AI)
Rilis yang sama dengan di atas, dinyatakan dalam ERN 4.3.2 dengan setiap field yang digunakan LabelGrid. Perhatikan perbedaannya dari versi 4.3: namespace /432 dan AvsVersionId="4", <DisplayGenre> alih-alih <Genre>, bentuk <Role><Value>…</Value></Role> kompleks, <ContainsAI> pada lagu / rilis / gambar, sebuah <AiContribution> pada setiap kontributor, dan seorang vokalis yang sepenuhnya AI yang dinyatakan dengan <SpecialContributor>GenerativeAI</SpecialContributor> (tanpa entri PartyList).
Metadata masukan (sama dengan contoh 4.3, ditambah pengungkapan AI):
| Field | Nilai |
|---|---|
| Generative AI Disclosure | Hanya bantuan AI ringan → Partly |
| Composition AI Disclosure | Tidak ada AI generatif → None |
| Artwork AI | Tidak ada AI generatif → None |
| Vokalis AI | Kredit yang sepenuhnya dihasilkan AI → SpecialContributor / All |
XML yang dihasilkan:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/432" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/432 http://ddex.net/xml/ern/432/release-notification.xsd" AvsVersionId="4" LanguageAndScriptCode="en">
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime> </MessageHeader>
<PartyList> <Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName> </Party> <Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName> </Party> <!-- No Party entry for the AI vocalist — it is declared via SpecialContributor --> </PartyList>
<ResourceList> <SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition> <WorkId> <ISWC>T3351864278</ISWC> </WorkId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<!-- Contributors use the complex Role form and carry an AiContribution --> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>ComposerLyricist</Value></Role> <AiContribution>None</AiContribution> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>StudioProducer</Value></Role> <AiContribution>None</AiContribution> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role><Value>MixingEngineer</Value></Role> <AiContribution>Partly</AiContribution> </Contributor> <!-- Fully AI-generated vocal credit: SpecialContributor replaces the party reference --> <Contributor SequenceNumber="4"> <SpecialContributor>GenerativeAI</SpecialContributor> <Role><Value>Vocalist</Value></Role> <AiContribution>All</AiContribution> </Contributor> <Contributor SequenceNumber="5"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role><Value>MusicPublisher</Value></Role> <AiContribution>Partly</AiContribution> </Contributor>
<WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController> <Duration>PT00H04M32S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType> <!-- Track-level AI = highest of Generative AI (Partly) and Composition AI (None) --> <ContainsAI>Partly</ContainsAI> <LanguageOfPerformance>en</LanguageOfPerformance> </SoundRecording>
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <!-- Artwork AI declaration, before TechnicalDetails --> <ContainsAI>None</ContainsAI> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails> </Image> </ResourceList>
<ReleaseList> <Release> <ReleaseReference>R0</ReleaseReference> <ReleaseType>Single</ReleaseType> <ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine> <!-- 4.3.2 uses DisplayGenre instead of Genre --> <DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </DisplayGenre> <OriginalReleaseDate>2025-08-15</OriginalReleaseDate> <ParentalWarningType>NotExplicit</ParentalWarningType> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup> <!-- Release-level AI = highest value across all tracks and artwork --> <ContainsAI>Partly</ContainsAI> </Release>
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </DisplayGenre> <Keywords>electronic deep house chill night</Keywords> </TrackRelease> </ReleaseList>
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal> </ReleaseDeal> </DealList>
</NewReleaseMessage>Judul multibahasa (Jepang)
Saat sebuah rilis memiliki metadata bahasa Inggris dan Jepang. Semua elemen DisplayTitleText muncul lebih dahulu, kemudian semua elemen DisplayTitle. Bacaan fonetik Jepang menggunakan ja-Kana (dipetakan dari ja-Jpan internal).
<!-- All DisplayTitleText elements first --><DisplayTitleText LanguageAndScriptCode="ja">夜明けの歌</DisplayTitleText><DisplayTitleText LanguageAndScriptCode="en">Song of Dawn</DisplayTitleText>
<!-- Then all DisplayTitle elements --><DisplayTitle LanguageAndScriptCode="ja"> <TitleText>夜明けの歌</TitleText> <SubTitle/></DisplayTitle><DisplayTitle LanguageAndScriptCode="en"> <TitleText>Song of Dawn</TitleText> <SubTitle/></DisplayTitle>
<!-- Japanese phonetic reading uses ja-Kana --><PartyName LanguageAndScriptCode="en"> <FullName>Yuki Tanaka</FullName></PartyName><PartyName LanguageAndScriptCode="ja-Kana"> <FullName>タナカ ユキ</FullName></PartyName>Poin penting:
- Kelompokkan semua elemen
DisplayTitleTextbersama-sama, kemudian semua elemenDisplayTitle - Gunakan
ja-Kanauntuk bacaan fonetik Jepang (katakana); ini dipetakan dari kodeja-Jpaninternal - Sediakan judul dalam setiap bahasa yang didukung
Lagu remix dengan versi mix
Saat sebuah lagu adalah remix, versi mix masuk ke SubTitle dan remixer mendapat peran tampilan FeaturedArtist sekaligus ArtisticRole berupa Remixer.
<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<SoundRecordingEdition> <ResourceId> <ISRC>GBXYZ2500042</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Deep Records</PLineText> </PLine> </SoundRecordingEdition>
<!-- DisplayTitleText uses base title only (NOT "Horizon (Koda Extended Mix)") --> <DisplayTitleText LanguageAndScriptCode="en">Horizon</DisplayTitleText> <!-- Mix version goes into SubTitle --> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Horizon</TitleText> <SubTitle>Koda Extended Mix</SubTitle> </DisplayTitle>
<DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave</DisplayArtistName>
<!-- Primary artist --> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist>
<!-- Remixer: uses FeaturedArtist for display + ArtisticRole=Remixer --> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> <ArtisticRole>Remixer</ArtisticRole> </DisplayArtist>
<Duration>PT00H06M45S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType></SoundRecording>Poin penting:
DisplayTitleTextberisi hanya judul dasar, tidak pernah bentuk gabungan seperti “Horizon (Koda Extended Mix)”- Versi mix masuk ke
SubTitledi dalamDisplayTitle - Remixer membutuhkan kedua
DisplayArtistRole=FeaturedArtistdanArtisticRole=Remixer - Jika judul multibahasa digunakan, lokalkan versi mix dalam setiap bahasa
Dolby Atmos (stereo + immersive)
Saat sebuah lagu memiliki versi stereo dan Dolby Atmos, SoundRecording berisi dua elemen SoundRecordingEdition: satu NonImmersiveEdition dan satu ImmersiveEdition. Masing-masing harus memiliki ISRC uniknya sendiri.
<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<!-- Stereo edition (marked NonImmersive when Dolby also exists) --> <SoundRecordingEdition> <Type>NonImmersiveEdition</Type> <ResourceId> <ISRC>USNS12500001</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<!-- Dolby Atmos / Immersive edition (separate ISRC required) --> <SoundRecordingEdition> <Type>ImmersiveEdition</Type> <ResourceId> <!-- Must be a different ISRC from the stereo edition --> <ISRC>USNS12500002</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <!-- Technical ref suffixed with "I" for immersive --> <TechnicalResourceDetailsReference>T1I</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="DolbyAtmos">UserDefined</AudioCodecType> <NumberOfChannels>8</NumberOfChannels> <SamplingRate>48000</SamplingRate> <BitsPerSample>24</BitsPerSample> <File> <!-- Dolby file uses "-dolby" suffix --> <URI>resources/198765432109_01_01-dolby.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>f1e2d3c4b5a6f1e2d3c4b5a6f1e2d3c4</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <!-- ... titles, artists, contributors, duration, parental warning ... --></SoundRecording>Poin penting:
- Edition stereo mendapat
<Type>NonImmersiveEdition</Type>hanya jika edition Dolby juga ada - Edition Dolby menggunakan
<Type>ImmersiveEdition</Type> - Setiap edition harus memiliki ISRC yang berbeda
TechnicalResourceDetailsReferenceimmersive diberi akhiranI(mis.T1I)- URI berkas audio Dolby menggunakan akhiran
-dolby - Dolby Atmos membutuhkan minimum 6 kanal (surround 5.1), biasanya 8 kanal
Pemilik hak cipta dengan pembagian wilayah
Beberapa pemilik hak cipta dengan pembagian persentase per wilayah. Elemen default-nya adalah WorkRightsController. Jika tidak ada pemilik hak cipta yang ditetapkan, label rekaman digunakan sebagai pengendali hak default sebesar 100%.
<!-- Copyright owner: 60% worldwide --><WorkRightsController> <RightsControllerPartyReference>P_OWNER_PUBLISHERA</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>60.00</RightSharePercentage> <Territory>Worldwide</Territory></WorkRightsController>
<!-- Copyright owner: 40% worldwide --><WorkRightsController> <RightsControllerPartyReference>P_OWNER_PUBLISHERB</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>40.00</RightSharePercentage> <Territory>Worldwide</Territory></WorkRightsController>Poin penting:
- Persentase harus berjumlah total tepat 100% per wilayah
- Gunakan
Worldwideuntuk cakupan global, atau kode wilayah ISO 3166-1 alpha-2 yang spesifik RightSharePercentagemenggunakan dua angka desimal (mis.60.00)- Satu outlet tertentu menggunakan
ResourceRightsControlleralih-alihWorkRightsController
Deal khusus wilayah
Saat sebuah rilis hanya tersedia di negara tertentu alih-alih seluruh dunia:
<Deal> <DealTerms> <!-- Available only in US, GB, DE, FR, and AU --> <TerritoryCode>US</TerritoryCode> <TerritoryCode>GB</TerritoryCode> <TerritoryCode>DE</TerritoryCode> <TerritoryCode>FR</TerritoryCode> <TerritoryCode>AU</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms></Deal>Poin penting:
- Cantumkan beberapa elemen
<TerritoryCode>dalamDealTermsyang sama - Gunakan kode ISO 3166-1 alpha-2 (mis.
US,GB,DE) - Hilangkan
Worldwidesaat menentukan wilayah secara individual
Takedown (menghapus sebuah rilis)
Saat Anda melakukan takedown, tanggal mulai dan tanggal akhir dalam periode validitas keduanya diatur ke 48 jam di masa lalu:
<Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-06-13</StartDate> <EndDate>2025-06-13</EndDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms></Deal>Poin penting:
StartDatedanEndDatekeduanya diatur ke tanggal yang sama, 48 jam di masa lalu- Ini menandakan kepada DSP bahwa rilis tersebut harus dihapus
- Sebuah deal takedown dibuat untuk setiap jenis model komersial
Referensi field-ke-XML
Section titled “Referensi field-ke-XML”Tabel pencarian cepat yang memetakan field metadata LabelGrid ke representasi XML DDEX-nya.
| Field LabelGrid | Elemen XML DDEX | Catatan |
|---|---|---|
| UPC/EAN | <ICPN> | Di dalam <ReleaseId> |
| ISRC | <ISRC> | Di dalam <ResourceId> di dalam <SoundRecordingEdition> |
| ISWC | <ISWC> | Di dalam <WorkId> pada <SoundRecording> induk (bukan di dalam Edition) |
| Judul | <DisplayTitleText> + <DisplayTitle> | Satu per bahasa; DisplayTitleText hanya menggunakan judul dasar |
| Versi mix | <SubTitle> | Di dalam <DisplayTitle> |
| Artis utama | <DisplayArtistRole>MainArtist</DisplayArtistRole> | |
| Artis unggulan | <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> | |
| Remixer | FeaturedArtist + <ArtisticRole>Remixer</ArtisticRole> | Kedua elemen diperlukan |
| Genre | <GenreText> + <SubGenre> | Dipetakan ke kode genre khusus DSP |
| P-Line | <PLine> > <Year> + <PLineText> | |
| C-Line | <CLine> > <Year> + <CLineText> | |
| Eksplisit | <ParentalWarningType> | Nilai: NotExplicit, Explicit, ExplicitContentEdited |
| Tanggal rilis | <OriginalReleaseDate> + deal <StartDate> | Format: YYYY-MM-DD |
| Wilayah | <TerritoryCode> | Worldwide atau ISO 3166-1 alpha-2 |
| Kontributor (Producer) | <Role>StudioProducer</Role> | Nama tampilan “Producer” memetakan ke DDEX StudioProducer |
| Kontributor (lainnya) | <Contributor> > <Role> | Kode peran DDEX (mis. ComposerLyricist, MixingEngineer) |
| Penerbit | <Role>MusicPublisher</Role> | Di dalam <Contributor> |
| Berkas audio | <File> > <URI> | Pola: resources/{UPC}_{disc}_{track}.{ext} |
| IPI | <IpiNameNumber> | Diisi nol di depan hingga 11 digit |
| ISNI | <ISNI> | 16 karakter |
| Sampul | <Image> dengan <Type>FrontCoverImage</Type> | |
| Jenis rilis | <ReleaseType> | Muncul sebelum <ReleaseId> di ERN 4.3 |
| Nomor katalog | <CatalogNumber> | Di dalam <ReleaseId> |
| Resource lagu | <ResourceGroup> > <ResourceGroupContentItem> | Bukan ReleaseResourceReferenceList |
| Durasi | <Duration> | Format ISO 8601: PT00H04M32S |
| Bahasa | <LanguageOfPerformance> | Kode bahasa ISO |
| Kata kunci | <Keywords> | Di dalam <TrackRelease> |
| Dolby stereo | <Type>NonImmersiveEdition</Type> | Hanya ada jika edition Dolby juga ada |
| Dolby Atmos | <Type>ImmersiveEdition</Type> | ISRC terpisah diperlukan; URI berkas menggunakan akhiran -dolby |
| Pemilik hak cipta | <WorkRightsController> | Dengan <RightSharePercentage> dan <Territory> |
Hanya ERN 4.3.1 / 4.3.2
Section titled “Hanya ERN 4.3.1 / 4.3.2”Elemen-elemen ini hanya ada di 4.3.1 dan 4.3.2 (tidak di 4.3.0). Lihat field deklarasi AI.
| Field LabelGrid | Elemen XML DDEX | Catatan |
|---|---|---|
| Genre (4.3.1+) | <DisplayGenre> | Menggantikan <Genre>; anak GenreText + SubGenre yang sama |
| Peran kontributor (4.3.1+) | <Role><Value>…</Value></Role> | Bentuk kompleks; <Value UserDefinedValue="…">UserDefined</Value> untuk peran nonstandar |
| AI pada lagu/rilis/artwork | <ContainsAI> | Nilai None / Partly / All; pada SoundRecording, Release, dan Image |
| AI per kontributor | <AiContribution> | Nilai None / Partly / All; anak dari <Contributor>, setelah <Role> |
| Kredit yang sepenuhnya dihasilkan AI | <SpecialContributor>GenerativeAI</SpecialContributor> | Menggantikan <ContributorPartyReference> (tanpa nama party) |
Daftar periksa struktur XML
Section titled “Daftar periksa struktur XML”Gunakan daftar periksa ini untuk memverifikasi XML Anda sebelum pengiriman:
-
<NewReleaseMessage>akar mencakup namespace dan lokasi skema ERN 4.3 -
<MessageHeader>memilikiMessageThreadId,MessageId, sender, dan recipient yang valid - Semua party (label, artis, kontributor, penerbit) didefinisikan di
<PartyList> - Setiap party memiliki
<PartyReference>yang unik - Tipe
<SoundRecording>adalahMusicalWorkSoundRecording - ISRC berada di dalam
<SoundRecordingEdition>><ResourceId> - ISWC (jika ada) berada pada
<SoundRecording>induk melalui<WorkId>, bukan di dalam Edition -
<DisplayTitleText>hanya berisi judul dasar (tanpa versi mix) - Versi mix (jika ada) berada di
<SubTitle>di dalam<DisplayTitle> - Remixer memiliki
DisplayArtistRole=FeaturedArtistdanArtisticRole=Remixer -
<URI>berkas audio mengikuti polaresources/{UPC}_{disc}_{track}.{ext} -
<Image>sampul memiliki<Type>FrontCoverImage</Type> -
<ReleaseType>muncul sebelum<ReleaseId>di<Release>utama - UPC/EAN berada di
<ICPN>di dalam<ReleaseId> - Resource ditautkan melalui
<ResourceGroup>(bukanReleaseResourceReferenceList) - Edition Dolby Atmos memiliki ISRC terpisah dari edition stereo
- Persentase
<WorkRightsController>berjumlah total 100% per wilayah -
<TerritoryCode>deal menggunakanWorldwideatau kode ISO 3166-1 alpha-2 yang valid - Semua tanggal menggunakan format
YYYY-MM-DD - Deal takedown memiliki
<StartDate>dan<EndDate>yang keduanya diatur 48 jam di masa lalu
Hanya ERN 4.3.1 / 4.3.2:
- Genre menggunakan
<DisplayGenre>(bukan<Genre>) - Setiap
<Contributor>menggunakan bentuk<Role><Value>…</Value></Role>kompleks -
<ContainsAI>ada pada setiap<SoundRecording>,<Release>, dan<Image>sampul, dengan nilaiNone,Partly, atauAll -
<ContainsAI>pada lagu berada setelah<ParentalWarningType>; pada gambar berada sebelum<TechnicalDetails> - Setiap
<Contributor>membawa<AiContribution>(None/Partly/All) tepat setelah<Role> - Kredit yang sepenuhnya dihasilkan AI menggunakan
<SpecialContributor>GenerativeAI</SpecialContributor>sebagai pengganti<ContributorPartyReference>
Butuh bantuan?
Section titled “Butuh bantuan?”Jika Anda membutuhkan bantuan terkait integrasi DDEX, hubungi tim dukungan kami beserta persyaratan teknis Anda.
Belum menggunakan LabelGrid?
Semua yang baru saja Anda baca tersedia di platform kami.
Lihat kemampuan LabelGrid →