新的音乐行业传输标准K-JSON

简介：

看见音乐传输标准，K-JSON格式，分为4部分。

  • 第一部分：主要的发送信息
  • 第二部分：传输类型
  • 第三部分：资源类型（元数据）
  • 第四部分：发行信息

第一部分为MessageHeader 主要的发送信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "tenantKey": "", //租户key 【必填】
    "contentProviderName": "", //cpName【必填】
    "kanjianVersion": "", //看见音乐标准版本【必填】
    "objectPath": "", //对象存储路径【非必填】
    "upc": "", //upc【必填】
    "bucket": "", //桶名称【非必填】
    "productKey": "", //作品id【必填】
    "messageThreadId": "", //对应本次出入库的任务id ->输出的文件名称【必填】
    "messageSender": { //发送方信息【必填】
        "partyId": "", //发送方id【必填，需要去DDEX网站申请】
        "partyName": { //发送方的partyName【必填】
            "fullName": "" //名称【必填】
        }
    },
    "messageRecipient": [ //接收方信息【必填】
        {
            "partyId": "", //接收方id【必填】
            "partyName": { //接收方的partyName【必填】
                "fullName": "" //名称【必填】
            }
        }
    ],
    "sentOnBehalfOf": { //cp信息【必填】
        "partyId": "", //cpid【必填】
        "partyName": { //原始发送方的partyName【必填】
            "fullName": "" //名称【必填】
        }
    },
    "messageCreatedDateTime": "", //本次信息生成时间【必填】
    /**
     * TestMessage 代表测试, LiveMessage 代表正式推送
     * TestMessage :代表测试
     * LiveMessage :代表正式推送
     */
    "messageControlType": "",【必填】
    "ddexVersion": "", //DDEX 传输版本【必填】
    "languageAndScriptCode": "" //DDEX头的语言信息【必填】
}

第二部分 传输类型

1
2
3
4
{
    "ContentState": "" //内容新增、更新、无【必填】
    "DigitalServiceProviderState":""// 上架、下架、全部下架、无【必填】
}

规则：

内容 新增 ContentStateEnum INSERT
更新 ContentStateEnum UPDATE
无 ｜ ContentStateEnum NULL
dsp 上架 DigitalServiceProviderState RELEASE
下架 DigitalServiceProviderState TAKE_DOWN
全部下架 DigitalServiceProviderState TAKE_DOWN_ALL
无 DigitalServiceProviderState NULL 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
//内容枚举
public enum ContentStateEnum {
//    UN_KNOW("UnKnow", "未知"),
    INSERT("INSERT", "新增"),
    UPDATE("UPDATE", "更新"),
    NULL("NULL", "无");


    private final String name;
    private final String description;

}
//dsp枚举
 public enum DigitalServiceProviderStateEnum {
    NULL("NULL", "未知"),
    RELEASE("RELEASE", "上架"),
    TAKE_DOWN("TAKE_DOWN", "下架"),
    TAKE_DOWN_ALL("TAKE_DOWN_ALL", "全部下架");


    private final String name;
    private final String description;
}

第三部分 ResourceList 资源列表 主要是资产的元数据信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
{
    "assets": [ //资产
        {
            "id": 0, //主键id【必填】
            "title": { //标题
                "defaultTitle": "", //默认标题【必填】
                "translates": [ //标题翻译
                    {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                    }
                ]
            },
            "subTitle": { //子标题
                "defaultTitle": "", //默认标题【必填】
                "translates": [ //标题翻译
                    {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                    }
                ]
            },
            /**
             * *
             * isrc
             */
            "isrc": "",【必填】
            "sort": 0, //排序【必填】
            "type": "", //资产类型  【必填】
            "displayArtist": { //展示艺人
                "defaultTitle": "", //默认标题【必填】
                "translates": [ //标题翻译
                    {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                    }
                ]
            },
             /**
         * *
         * 	NONE_EXPLICIT("NONE_EXPLICIT", 0, "无脏标", "無髒標", "none explicit"),
						HAVE_EXPLICIT("HAVE_EXPLICIT", 1, "有脏标", "有髒標", "have explicit"),
						CLEAN("CLEAN", 2, "纯净版", "純淨版", "clean");
         */
            "explicit": "", //脏标【必填】
            "catalogNo": "", //catalogNo
            "pYear": "", //pYear【必填】
            "pText": "", //pText【必填】
            "lyrics": "", //歌词
            "mainArtistList": [
              { //主要表演者角色
                "artist": { //艺人
                    "name": "", //名称【必填，至少有一个】
                    "languageScriptCode": "", //语种code
                    "label": { //厂牌
                        "id": 0, //主键id
                        "name": "" //名称
                    },
                    "sort": 0, //排序【必填】
                    "translate": [ //翻译
                        {
                            "languageScriptCode": "", //语种code
                            "name": "", //翻译名称
                            "applicableTerritoryCode": "" //翻译涉及地区
                        }
                    ]
                }
            	}
            ],
            "featArtistList": [
              { //feat表演者角色
                "artist": { //艺人
                    "name": "", //名称【有数据的话必填】
                    "languageScriptCode": "", //语种code
                    "label": { //厂牌
                        "id": 0, //主键id
                        "name": "" //名称
                    },
                    "sort": 0, //排序【有数据的话必填】
                    "translate": [ //翻译
                        {
                            "languageScriptCode": "", //语种code
                            "name": "", //翻译名称
                            "applicableTerritoryCode": "" //翻译涉及地区
                        }
                    ]
                }
            	}
            ],
            "contributorList": [ //贡献者角色
              {
                "artist": [ //多个艺人 
                  {
                    "name": "", //名称【有数据的话必填】
                    "languageScriptCode": "", //语种code
                    "label": { //厂牌
                      "id": 0, //主键id
                      "name": "" //名称
                    },
                    "sort": 0,//排序【有数据的话必填】 艺人在角色中的排序
                    "translate": [ //翻译
                      {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                      }
                    ]
                  }
                ],
                "code": "", //角色code
                "name": "", //角色name
                "sort": 0 // 当前排序是多个角色时排序 例子：1.贡献者2.作词
              }
          ],
            "genre": { //风格
                "id": 0, //风格id【必填】
                "name": "" //名称【必填】
            },
            "subGenre": { //子风格
                "id": 0, //主键id
                "name": "" //名称
            },
            "label": { //厂牌
                "id": 0, //主键id
                "name": "" //名称【必填】
            },
            "languageScriptCode": "", //语种
            "performanceOfLanguageCode": "", //音频语种【必填】
            "audioFile": { //音频文件
                "name": "", //音频文件名称【必填】
                "bucket": "", //oss桶名称【必填】
                "path": "", //oss 路径名称【必填】
                "duration": 0, //时长
                "bitRate": 0.0, //码率
                "channels": 0, //声道数
                "numberOfChannels": "", //通道数
                "samplingRate": "", //采样率
                "bitDepth": 0 //比特率
            }
        }
    ],
    "product": { //作品
        "id": 0, //主键id【必填】
        "title": { //标题
            "defaultTitle": "", //默认标题【必填】
            "translates": [ //标题翻译
                {
                    "languageScriptCode": "", //语种code
                    "name": "", //翻译名称
                    "applicableTerritoryCode": "" //翻译涉及地区
                }
            ]
        },
        "subTitle": { //子标题
            "defaultTitle": "", //默认标题【必填】
            "translates": [ //标题翻译
                {
                    "languageScriptCode": "", //语种code
                    "name": "", //翻译名称
                    "applicableTerritoryCode": "" //翻译涉及地区
                }
            ]
        },
        /**
         * *
         * upc
         */
        "upc": "",【必填】
        "type": "", //作品类型【必填】
        "subType":""//作品子类型 【必填】
         /**
         * *
         * 	NONE_EXPLICIT("NONE_EXPLICIT", 0, "无脏标", "無髒標", "none explicit"),
						HAVE_EXPLICIT("HAVE_EXPLICIT", 1, "有脏标", "有髒標", "have explicit"),
						CLEAN("CLEAN", 2, "纯净版", "純淨版", "clean");
         */
        "explicit": "", //脏标【必填】   
        "catalogNo": "", //catalogNo
        "displayArtist": { //展示艺人
            "defaultTitle": "", //默认标题【必填】
            "translates": [ //标题翻译
                {
                    "languageScriptCode": "", //语种code
                    "name": "", //翻译名称
                    "applicableTerritoryCode": "" //翻译涉及地区
                }
            ]
        },
        "cYear": "", //cYear【必填】
        "cText": "", //cText【必填】
        "pYear": "", //pYear【必填】
        "pText": "", //pText【必填】
        "releaseDate": "", //发行时间  "yyyy-MM-dd hh:mm:ss"【必填】
        "containsContent": "", //内容
        "languageScriptCode": "", //语种
        "label": { //厂牌
            "id": 0, //主键id【必填】
            "name": "" //名称【必填】
        },
        "genre": { //风格
            "id": 0, //风格id【必填】
            "name": "" //名称【必填】
        },
        "subGenre": { //子风格
            "id": 0, //主键id
            "name": "" //名称
        },
        "mainArtistList": [{ //主要表演者角色
            "artist": { //艺人
                "name": "", //名称【必填】
                "languageScriptCode": "", //语种code
                "label": { //厂牌
                    "id": 0, //主键id
                    "name": "" //名称
                },
                "sort": 0, //排序【必填】
                "translate": [ //翻译
                    {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                    }
                ]
            }
        }],
        "featArtistList": [{ //feat表演者角色
            "artist": { //艺人
                "name": "", //名称【有的话必填】
                "languageScriptCode": "", //语种code
                "label": { //厂牌
                    "id": 0, //主键id
                    "name": "" //名称
                },
                "sort": 0, //排序【有的话必填】
                "translate": [ //翻译
                    {
                        "languageScriptCode": "", //语种code
                        "name": "", //翻译名称
                        "applicableTerritoryCode": "" //翻译涉及地区
                    }
                ]
            }
        }],
        "coverFile": { //作品展示图
            "name": "", //图片名称【必填】
            "bucket": "", //oss桶名称【必填】
            "path": "" //oss路径【必填】
        }
    }
}

第四部分 ReleaseList 发行信息内置DSP相关信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
    "dsps": [ //dsp
        {
            "id": 0, //主键id【必填】
            "name": "", //名称【必填】
            "releaseDate": "", //发行日期 "yyyy-MM-dd"【必填】
            "releaseTime": "", //发行时间 "HH:mm:ss"
            "territoryCodes": [ //发行地区
                  "CN","TW" //地区code【必填】
            ],
            "validtyPeriod": { //合法时间和结束时间
                "startDate": "", //开始时间 "yyyy-MM-dd hh:mm:ss"【必填】
                "endDate": "" //结束时间 "yyyy-MM-dd hh:mm:ss"【必填】
            },
            "CommercialModelTypes": [ //付费方式
                {
                    "code": "" //付费code【必填】
                }
            ],
            "Usage": [ //付费方式
                {
                    "code": "" //付费code【必填】
                }
            ]
        }
    ]
}