DDEX 对接方案

概述

本方案适用于自建曲库的客户，用于管理曲库对外的音乐信息和版权信息的传输。DDEX 为国际标准音乐传输协议，支持音频文件及相关资料的传输、支持版权授权和过期的信息同步。具体可参考DDEX 官网 (opens new window)。

准备工作

1. 客户方提供 FTP 地址、提供 DDEX 的 DPID 和 PD Name（非 DPID 和 DP Name 非必须，但是有助于系统良好对接）。
2. 阅读理解 DDEX 的 XML 样例注释文档。
   1. DDEX 新增_案例 (opens new window)
   2. DDEX 更新_案例 (opens new window)
   3. DDEX 下架_案例 (opens new window)

DMH 资料

1. DMH 支持 DDEX ERN 标准，目前支持标准 DDEX ERN 3.8.2 分发。
2. DMH 提供的物料
   1. 封面，以下文件格式范围，任选一种方式：
      1. 接受转码后的 JPG 图片：可能会接收到 JPG 或 JPEG 后缀的 JPG 文件
      2. 接受原始封面格式：可能存在 JPG、JPEG、TIF、PNG 等常见的图片格式
   2. 音频，以下音频文件格式，任选一种方式：
      1. 只接受 WAV 格式文件（注：如果只接受该音频格式，可能选择曲库的选择范围会更小），典型的文件大小为 25M 每首歌
      2. 只接受 FLAC 文件格式（注：如果只接受该音频格式，可能选择曲库的选择范围会更小），典型的文件大小为 15M 每首歌
      3. 只接受 mp3 文件
      4. 接受原始音频，接收到的音频格式可能有：mp3，wav，FLAC 以及其他版权方提供的原始音频格式
   3. 歌词，将会传输原始的歌词文件，可能存在 lrc、txt、Word 文件等歌词格式

特别说明

1. 专辑传输方式，DDEX 协议传输的专辑信息及其物料信息将会以这种方式放在客户方的 FTP 服务器上，说明：以下为两个文件的举例，文件名空格后为注释说明：

delivery_directory  指定的用于接受 DDEX 文件的根目录

• 2020101113239923*982333433  一张专辑的文件根目录，前部分为时间戳，*后有 UPC（或者虚拟 UPC，即唯一定义为专辑的 Code）
  • 982333433.xml  DDEX 中的 XML 文件，用于描述专辑、歌曲的基本信息，信息注释请查看示例文档；当物料传输完成后，才会写这个文件，此文件写完成后，客户方可以读取专辑整个文件夹
  • resources  用于存放物料的文件，如果该专辑第一分发给平台后，后续分发只是更新了专辑信息，没有跟新物料信息，则无文件夹
    • 982333433.png 专辑的封面文件
    • 982333433_1.wav 第一首歌的音频物料文件
    • 982333433_2.mp3 第二首歌的音频物料文件
    • 982333433_2_1.lrc  歌词文件（如果有歌词，则会传输
• 2020101113239923_982333434  另一张专辑的文件跟目录，以下不再赘述每个文件