{"data":{"id":"853989","string_id":"ufufA0VZ","status":"1","parent_id":"76082","slug":"ufufA0VZ","order":"23","name":"\u5e7f\u544a\u7d20\u6750\u63a2\u6d4b","type":"1","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"Welch","published_time":"0","add_time":"1782962722","update_time":"1782963958","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"\u5176\u4ed6","parent_type":"1","parent_slug":"GUIbTl","child":[{"id":"834582","string_id":"qDFJP6v6","status":"1","parent_id":"853989","slug":"qDFJP6v6","order":"1","name":"\u5e7f\u544a\u63a2\u6d4b\u5668","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u738b\u65b0\u6708","published_time":"1782900747","add_time":"1782384397","update_time":"1782963958","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"834582","content":"

\n

\u4e00\u3001\u529f\u80fd\u6982\u8ff0<\/span><\/h1>\n
\u5e7f\u544a\u63a2\u6d4b\u5668\u662f Taku \u5f00\u53d1\u8005\u540e\u53f0\u300c\u9ad8\u7ea7\u529f\u80fd\u300d\u4e0b\u7684\u80fd\u529b\u6a21\u5757\uff0c\u7528\u4e8e\u5c06\u5e7f\u544a\u5c55\u793a\u65f6\u7684\u7d20\u6750\u622a\u56fe\u4e0e\u5bf9\u5e94\u7684\u5e7f\u544a\u94fe\u8def\u4fe1\u606f\u7559\u5b58\u5230\u5e73\u53f0\uff0c\u4fbf\u4e8e\u5f00\u53d1\u8005\u5728\u4e8b\u540e\u901a\u8fc7\u591a\u7ef4\u5ea6\u7b5b\u9009\u6216\u4ee5\u56fe\u641c\u56fe\u7684\u65b9\u5f0f\u67e5\u8be2\u5df2\u5c55\u793a\u7684\u5e7f\u544a\u7d20\u6750\u3002<\/span><\/p>\n
\u529f\u80fd\u6784\u6210<\/span><\/h3>\n<\/colgroup>\n\n\n\n\n
\n
\u6a21\u5757<\/span><\/p>\n<\/td>\n
\n
\u8bf4\u660e<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u7d20\u6750\u6536\u96c6\u5c55\u793a<\/span><\/p>\n<\/td>\n
\n
\u5c55\u793a\u5df2\u91c7\u96c6\u7684\u5e7f\u544a\u7d20\u6750\u5217\u8868\uff0c\u5e76\u67e5\u770b\u6bcf\u6761\u8bb0\u5f55\u5bf9\u5e94\u7684\u5e7f\u544a\u4e0e\u8bbe\u5907\u4fe1\u606f\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u4ee5\u56fe\u641c\u56fe<\/span><\/p>\n<\/td>\n
\n
\u4e0a\u4f20\u4e00\u5f20\u56fe\u7247\uff0c\u7cfb\u7edf\u901a\u8fc7\u56fe\u7247\u7279\u5f81\u5339\u914d\u8fd4\u56de\u6700\u76f8\u4f3c\u7684\u5df2\u91c7\u96c6\u7d20\u6750\u53ca\u5176\u5bf9\u5e94\u7684\u5e7f\u544a\u4e0e\u8bbe\u5907\u4fe1\u606f\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\u6d41\u7a0b\u6982\u8ff0<\/span><\/h3>\n
\n
\n
\u5f00\u53d1\u8005\u5728\u5e7f\u544a\u5c55\u793a\u56de\u8c03\u4e2d\u83b7\u53d6\u622a\u56fe\uff0c\u518d\u8c03\u7528\u7d20\u6750\u4e0a\u62a5 API\u5c06\u7d20\u6750\u622a\u56fe\u4e0a\u62a5\u5230\u670d\u52a1\u7aef\u8fdb\u884c\u5b58\u50a8\u5c55\u793a\uff1b<\/span><\/div>\n<\/li>\n
\n
\u5f00\u53d1\u8005\u5728\u5e7f\u544a\u63a2\u6d4b\u5668\u9875\u9762\u901a\u8fc7\u591a\u7ef4\u5ea6\u7b5b\u9009\u6d4f\u89c8\u7d20\u6750\u6570\u636e\u5217\u8868\uff0c\u6216\u901a\u8fc7\u300c\u4ee5\u56fe\u641c\u56fe\u300d\u5165\u53e3\u4e0a\u4f20\u5ba2\u8bc9\u56fe\u7247\u5339\u914d\u5b9a\u4f4d\u95ee\u9898\u7d20\u6750\u6765\u6e90<\/span><\/div>\n<\/li>\n<\/ol>\n
\n
\u4e8c\u3001\u64cd\u4f5c\u6307\u5f15<\/span><\/h1>\n
2.1 \u5982\u9700\u4f7f\u7528\u8bf7\u8054\u7cfb\u8fd0\u8425\u5f00\u901a\u529f\u80fd\u6743\u9650<\/span><\/h2>\n
\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3a\u5f00\u53d1\u8005\u7ea7\u522b\u7684\u589e\u503c\u80fd\u529b\uff0c\u5982\u9700\u4f7f\u7528\u8bf7\u8054\u7cfb\u5bf9\u63a5\u7684 Taku \u5546\u52a1 \/ \u8fd0\u8425\u540c\u5b66\u7533\u8bf7\u5f00\u901a\u3002<\/span><\/p>\n
2.2 \u7d20\u6750\u6536\u96c6\u5c55\u793a\u529f\u80fd<\/span><\/h2>\n
2.2.1 \u8fdb\u5165\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762<\/span><\/h3>\n
\u767b\u5f55 Taku \u5f00\u53d1\u8005\u540e\u53f0\uff0c\u4f9d\u6b21\u70b9\u51fb\u300c\u9ad8\u7ea7\u529f\u80fd → \u5e7f\u544a\u63a2\u6d4b\u5668\u300d\uff0c\u8fdb\u5165\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762\u3002<\/span><\/p>\n
\n
<\/p>\n<\/article>\n
2.2.2 \u6570\u636e\u5217\u8868\u5b57\u6bb5\u8bf4\u660e<\/span><\/h3>\n
\u6570\u636e\u5217\u8868\u4ee5\u8bb0\u5f55\u5f62\u5f0f\u5c55\u793a\u6ee1\u8db3\u67e5\u8be2\u6761\u4ef6\u7684\u7d20\u6750\uff0c\u6bcf\u6761\u8bb0\u5f55\u5305\u542b\u4e00\u5f20\u7f29\u7565\u56fe\u548c\u5bf9\u5e94\u7684\u5e7f\u544a \/ \u8bbe\u5907\u4fe1\u606f\u5b57\u6bb5\u3002\u5404\u5b57\u6bb5\u542b\u4e49\u5982\u4e0b\uff1a<\/span><\/p>\n
<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n
\u5217\u540d<\/span><\/p>\n<\/td>\n
\n
\u5b57\u6bb5\u8bf4\u660e<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u4e0a\u62a5\u65f6\u95f4<\/span><\/p>\n<\/td>\n
\n
\u7d20\u6750\u4e0a\u62a5\u65f6\u95f4\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u7d20\u6750\u7f29\u7565\u56fe<\/span><\/p>\n<\/td>\n
\n
\u622a\u56fe\u7f29\u7565\u56fe\uff0c\u70b9\u51fb\u53ef\u67e5\u770b\u622a\u56fe\u5927\u56fe<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u7cfb\u7edf\u5e73\u53f0<\/span><\/p>\n<\/td>\n
\n
Android \/ iOS<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e94\u7528<\/span><\/p>\n<\/td>\n
\n
\u5f00\u53d1\u8005\u5df2\u5728\u540e\u53f0\u521b\u5efa\u7684\u5e94\u7528<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e7f\u544a\u4f4d<\/span><\/p>\n<\/td>\n
\n
\u6240\u9009\u5e94\u7528\u4e0b\u7684\u5e7f\u544a\u4f4d<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e7f\u544a\u7c7b\u578b<\/span><\/p>\n<\/td>\n
\n
\u6240\u9009\u5e7f\u544a\u4f4d\u5e7f\u544a\u6837\u5f0f\u7c7b\u578b<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e7f\u544a\u5e73\u53f0<\/span><\/p>\n<\/td>\n
\n
\u5e7f\u544a\u5e73\u53f0\u6e20\u9053\uff08\u5982 Pangle\u3001AdMob\u3001Mintegral \u7b49\uff09<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e7f\u544a\u6e90<\/span><\/p>\n<\/td>\n
\n
\u5177\u4f53\u7684\u5e7f\u544a\u6e90<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u8bbe\u5907 ID<\/span><\/p>\n<\/td>\n
\n
\u8bbe\u5907\u552f\u4e00\u6807\u8bc6<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
Taku Request ID<\/span><\/p>\n<\/td>\n
\n
Taku \u53d1\u8d77\u5e7f\u544a\u52a0\u8f7d\u65f6\u7684\u8bf7\u6c42 ID<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5e7f\u544a\u5e73\u53f0 Creative ID<\/span><\/p>\n<\/td>\n
\n
\u5e7f\u544a\u5e73\u53f0\u4fa7\u7684\u7d20\u6750 ID<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u8bf7\u6c42\u65f6\u95f4<\/span><\/p>\n<\/td>\n
\n
\u5e7f\u544a\u8bf7\u6c42\u53d1\u8d77\u65f6\u95f4<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u586b\u5145\u65f6\u95f4<\/span><\/p>\n<\/td>\n
\n
\u5e7f\u544a\u586b\u5145\u83b7\u53d6\u65f6\u95f4<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u5c55\u793a\u65f6\u95f4<\/span><\/p>\n<\/td>\n
\n
\u5e7f\u544a\u5c55\u793a \/ \u66dd\u5149\u65f6\u95f4<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
2.3 \u4ee5\u56fe\u641c\u56fe\u529f\u80fd<\/span><\/h2>\n
\u4ee5\u56fe\u641c\u56fe\u7528\u4e8e\u5728\u62e5\u6709\u4e00\u5f20\u5ba2\u8bc9\u622a\u56fe\u6216\u624b\u673a\u7ffb\u62cd\u7167\u7247\u65f6\uff0c\u5feb\u901f\u4ece\u5e73\u53f0\u5df2\u91c7\u96c6\u7684\u7d20\u6750\u5e93\u4e2d\u5339\u914d\u51fa\u6700\u76f8\u4f3c\u7684\u7d20\u6750\u8bb0\u5f55\uff0c\u4ece\u800c\u5b9a\u4f4d\u5e7f\u544a\u5e73\u53f0\u3001\u5e7f\u544a\u6e90\u548c\u8bbe\u5907\u3002\u5339\u914d\u7b97\u6cd5\u5bf9\u622a\u56fe\u88c1\u526a\u3001\u5206\u8fa8\u7387\u5dee\u5f02\u4ee5\u53ca\u624b\u673a\u7ffb\u62cd\u5f15\u5165\u7684\u6469\u5c14\u7eb9\u3001\u89d2\u5ea6\u504f\u79fb\u5177\u5907\u4e00\u5b9a\u5bb9\u5fcd\u5ea6\uff0c\u4f46\u4e3a\u4e86\u4fdd\u8bc1\u5339\u914d\u6210\u529f\u7387\uff0c\u5efa\u8bae\u5c3d\u91cf\u6309\u7167\u4ee5\u4e0b\u8981\u6c42\u8fdb\u884c\u62cd\u6444\uff1a<\/span><\/p>\n
\n
\n
\u62cd\u7167\u65f6\u5c06\u9700\u8981\u641c\u7d22\u7684\u5185\u5bb9\u586b\u6ee1\u6574\u4e2a\u753b\u9762<\/span><\/div>\n<\/li>\n
\n
\u5c3d\u91cf\u51cf\u5c11\u53cd\u5149<\/span><\/div>\n<\/li>\n
\n
\u50cf\u7d20\u5c3d\u91cf\u9ad8<\/span><\/div>\n<\/li>\n<\/ol>\n
2.3.1 \u8fdb\u5165\u4ee5\u56fe\u641c\u56fe\u5165\u53e3<\/span><\/h3>\n
\u5728\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762\u70b9\u51fb\u53f3\u4e0a\u65b9\u300c\u4ee5\u56fe\u641c\u56fe\u300d\u6309\u94ae\uff0c\u4f1a\u4ee5\u5f39\u7a97 \/ \u5b50\u9875\u9762\u7684\u5f62\u5f0f\u6253\u5f00\u56fe\u7247\u4e0a\u4f20\u754c\u9762\u3002<\/span><\/p>\n
<\/p>\n
<\/p>\n
2.3.2 \u4e0a\u4f20\u5f85\u5339\u914d\u56fe\u7247<\/span><\/h3>\n
\u5728\u4e0a\u4f20\u533a\u57df\u9009\u62e9\u672c\u5730\u56fe\u7247\uff0c\u6216\u5c06\u56fe\u7247\u62d6\u62fd\u5230\u4e0a\u4f20\u6846\u5185\u3002\u652f\u6301\u7684\u683c\u5f0f\u4e3a JPG \/ PNG\uff0c\u5355\u5f20\u56fe\u7247\u5927\u5c0f\u4e0d\u8d85\u8fc7 5MB\uff0c\u65e2\u652f\u6301\u7cfb\u7edf\u622a\u56fe\u4e5f\u652f\u6301\u624b\u673a\u62cd\u7167\u5f97\u5230\u7684\u7167\u7247\u3002 <\/span><\/p>\n
2.3.3 \u67e5\u770b\u5339\u914d\u7ed3\u679c<\/span><\/h3>\n
\u5339\u914d\u5b8c\u6210\u540e\u4f1a\u8fd4\u56de\u7ed3\u679c\u9875\u3002\u7ed3\u679c\u9875\u4f1a\u81ea\u52a8\u6e05\u9664\u4e3b\u9875\u9762\u7684\u5176\u4ed6\u7b5b\u9009\u9879\uff0c\u4ec5\u5c55\u793a\u4e0e\u672c\u6b21\u641c\u7d22\u76f8\u5173\u7684\u7d20\u6750\uff1a<\/span><\/p>\n
\n
\n
<\/span>\u6240\u6709\u5339\u914d\u5ea6\u4e3a 100% \u7684\u7d20\u6750\uff08\u5373\u4e0e\u4e0a\u4f20\u56fe\u7247\u9ad8\u5ea6\u4e00\u81f4\u7684\u7559\u5b58\u622a\u56fe\uff09\u3002<\/span><\/div>\n<\/li>\n
\n
<\/span>\u82e5\u4e0d\u8db3\u65f6\uff0c\u4f1a\u8865\u5145\u5339\u914d\u5ea6\u672a\u5230 100% \u7684\u76f8\u4f3c\u7d20\u6750\uff0c\u6574\u4f53\u8fd4\u56de \u5339\u914d\u5ea6Top 3~5 \u5f20\u5019\u9009\u622a\u56fe\u3002<\/span><\/div>\n<\/li>\n<\/ul>\n
\u7ed3\u679c\u4ee5\u5217\u8868\u5f62\u5f0f\u5c55\u793a\uff0c\u5b57\u6bb5\u4e0e\u300c\u7d20\u6750\u6536\u96c6\u5c55\u793a\u300d\u4e2d\u7684\u6570\u636e\u5217\u8868\u5b8c\u5168\u4e00\u81f4\uff0c\u5305\u62ec\u7f29\u7565\u56fe\u3001\u5e7f\u544a\u5e73\u53f0\u3001\u5e7f\u544a\u6e90\u3001\u8bbe\u5907 ID\u3001\u5404\u7c7b\u65f6\u95f4\u6233\u7b49\u3002\u70b9\u51fb\u7f29\u7565\u56fe\u540c\u6837\u53ef\u67e5\u770b\u622a\u56fe\u8be6\u60c5\u3002<\/span><\/p>\n
<\/p>\n
2.3.4 \u5e38\u89c1\u95ee\u9898<\/span><\/h3>\n<\/colgroup>\n\n\n\n\n\n\n
\n
\u95ee\u9898<\/span><\/p>\n<\/td>\n
\n
\u8bf4\u660e \/ \u5904\u7406\u5efa\u8bae<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u4e0a\u4f20\u56fe\u7247\u63d0\u793a\u6587\u4ef6\u8fc7\u5927<\/span><\/p>\n<\/td>\n
\n
\u68c0\u67e5\u56fe\u7247\u662f\u5426\u8d85\u8fc7 5MB\uff0c\u53ef\u4f7f\u7528\u622a\u56fe\u5de5\u5177\u6216\u56fe\u7247\u538b\u7f29\u540e\u518d\u4e0a\u4f20\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u4e0a\u4f20\u56fe\u7247\u63d0\u793a\u683c\u5f0f\u4e0d\u652f\u6301<\/span><\/p>\n<\/td>\n
\n
\u5f53\u524d\u4ec5\u652f\u6301 JPG \/ PNG \u683c\u5f0f\uff0c\u8bf7\u5148\u8f6c\u6362\u683c\u5f0f\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u641c\u7d22\u7ed3\u679c\u4e3a\u7a7a\u6216\u5339\u914d\u5ea6\u666e\u904d\u504f\u4f4e<\/span><\/p>\n<\/td>\n
\n
\u53ef\u80fd\u539f\u56e0\uff1a(1) \u8be5\u7d20\u6750\u672a\u88ab\u91c7\u96c6\uff08\u5bf9\u5e94\u5e94\u7528 \/ \u5e7f\u544a\u5e73\u53f0 \/ \u5e7f\u544a\u6837\u5f0f\u672a\u542f\u7528\u76d1\u6d4b\uff09\uff1b(2) \u5df2\u8d85\u8fc7\u7d20\u6750\u5b58\u50a8\u5468\u671f\uff1b(3) \u5ba2\u8bc9\u56fe\u7247\u4e0e\u539f\u59cb\u5c55\u793a\u753b\u9762\u5dee\u5f02\u8fc7\u5927\uff08\u4f8b\u5982\u4e8c\u6b21\u7f16\u8f91\u3001\u88c1\u5207\u8fc7\u591a\uff09\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n
\n
\u540c\u4e00\u5f20\u56fe\u8fd4\u56de\u591a\u6761 100% \u5339\u914d\u8bb0\u5f55<\/span><\/p>\n<\/td>\n
\n
\u5c5e\u4e8e\u6b63\u5e38\u73b0\u8c61——\u8be5\u7d20\u6750\u5728\u4e0d\u540c\u8bbe\u5907 \/ \u4e0d\u540c\u65f6\u95f4\u88ab\u591a\u6b21\u5c55\u793a\uff0c\u5206\u522b\u7559\u5b58\u4e86\u72ec\u7acb\u7684\u5c55\u793a\u8bb0\u5f55\uff0c\u53ef\u636e\u6b64\u8fdb\u4e00\u6b65\u5b9a\u4f4d\u5177\u4f53\u8bbe\u5907\u3002<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/p>\n<\/article>","pure_content":"\u4e00\u3001\u529f\u80fd\u6982\u8ff0\n\u5e7f\u544a\u63a2\u6d4b\u5668\u662f Taku \u5f00\u53d1\u8005\u540e\u53f0\u300c\u9ad8\u7ea7\u529f\u80fd\u300d\u4e0b\u7684\u80fd\u529b\u6a21\u5757\uff0c\u7528\u4e8e\u5c06\u5e7f\u544a\u5c55\u793a\u65f6\u7684\u7d20\u6750\u622a\u56fe\u4e0e\u5bf9\u5e94\u7684\u5e7f\u544a\u94fe\u8def\u4fe1\u606f\u7559\u5b58\u5230\u5e73\u53f0\uff0c\u4fbf\u4e8e\u5f00\u53d1\u8005\u5728\u4e8b\u540e\u901a\u8fc7\u591a\u7ef4\u5ea6\u7b5b\u9009\u6216\u4ee5\u56fe\u641c\u56fe\u7684\u65b9\u5f0f\u67e5\u8be2\u5df2\u5c55\u793a\u7684\u5e7f\u544a\u7d20\u6750\u3002\n\u529f\u80fd\u6784\u6210\n\n\n\n \u6a21\u5757\n \u8bf4\u660e\n\n\n \u7d20\u6750\u6536\u96c6\u5c55\u793a\n \u5c55\u793a\u5df2\u91c7\u96c6\u7684\u5e7f\u544a\u7d20\u6750\u5217\u8868\uff0c\u5e76\u67e5\u770b\u6bcf\u6761\u8bb0\u5f55\u5bf9\u5e94\u7684\u5e7f\u544a\u4e0e\u8bbe\u5907\u4fe1\u606f\u3002\n\n\n \u4ee5\u56fe\u641c\u56fe\n \u4e0a\u4f20\u4e00\u5f20\u56fe\u7247\uff0c\u7cfb\u7edf\u901a\u8fc7\u56fe\u7247\u7279\u5f81\u5339\u914d\u8fd4\u56de\u6700\u76f8\u4f3c\u7684\u5df2\u91c7\u96c6\u7d20\u6750\u53ca\u5176\u5bf9\u5e94\u7684\u5e7f\u544a\u4e0e\u8bbe\u5907\u4fe1\u606f\u3002\n\n\n\n\u6d41\u7a0b\u6982\u8ff0\n\n\n\u5f00\u53d1\u8005\u5728\u5e7f\u544a\u5c55\u793a\u56de\u8c03\u4e2d\u83b7\u53d6\u622a\u56fe\uff0c\u518d\u8c03\u7528\u7d20\u6750\u4e0a\u62a5 API\u5c06\u7d20\u6750\u622a\u56fe\u4e0a\u62a5\u5230\u670d\u52a1\u7aef\u8fdb\u884c\u5b58\u50a8\u5c55\u793a\uff1b\n\n\n\u5f00\u53d1\u8005\u5728\u5e7f\u544a\u63a2\u6d4b\u5668\u9875\u9762\u901a\u8fc7\u591a\u7ef4\u5ea6\u7b5b\u9009\u6d4f\u89c8\u7d20\u6750\u6570\u636e\u5217\u8868\uff0c\u6216\u901a\u8fc7\u300c\u4ee5\u56fe\u641c\u56fe\u300d\u5165\u53e3\u4e0a\u4f20\u5ba2\u8bc9\u56fe\u7247\u5339\u914d\u5b9a\u4f4d\u95ee\u9898\u7d20\u6750\u6765\u6e90\n\n\n\n\u4e8c\u3001\u64cd\u4f5c\u6307\u5f15\n2.1 \u5982\u9700\u4f7f\u7528\u8bf7\u8054\u7cfb\u8fd0\u8425\u5f00\u901a\u529f\u80fd\u6743\u9650\n\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3a\u5f00\u53d1\u8005\u7ea7\u522b\u7684\u589e\u503c\u80fd\u529b\uff0c\u5982\u9700\u4f7f\u7528\u8bf7\u8054\u7cfb\u5bf9\u63a5\u7684 Taku \u5546\u52a1 \/ \u8fd0\u8425\u540c\u5b66\u7533\u8bf7\u5f00\u901a\u3002\n2.2 \u7d20\u6750\u6536\u96c6\u5c55\u793a\u529f\u80fd\n2.2.1 \u8fdb\u5165\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762\n\u767b\u5f55 Taku \u5f00\u53d1\u8005\u540e\u53f0\uff0c\u4f9d\u6b21\u70b9\u51fb\u300c\u9ad8\u7ea7\u529f\u80fd \u2192 \u5e7f\u544a\u63a2\u6d4b\u5668\u300d\uff0c\u8fdb\u5165\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762\u3002\n\n\n\n2.2.2 \u6570\u636e\u5217\u8868\u5b57\u6bb5\u8bf4\u660e\n\u6570\u636e\u5217\u8868\u4ee5\u8bb0\u5f55\u5f62\u5f0f\u5c55\u793a\u6ee1\u8db3\u67e5\u8be2\u6761\u4ef6\u7684\u7d20\u6750\uff0c\u6bcf\u6761\u8bb0\u5f55\u5305\u542b\u4e00\u5f20\u7f29\u7565\u56fe\u548c\u5bf9\u5e94\u7684\u5e7f\u544a \/ \u8bbe\u5907\u4fe1\u606f\u5b57\u6bb5\u3002\u5404\u5b57\u6bb5\u542b\u4e49\u5982\u4e0b\uff1a\n\n\n\n \u5217\u540d\n \u5b57\u6bb5\u8bf4\u660e\n\n\n \u4e0a\u62a5\u65f6\u95f4\n \u7d20\u6750\u4e0a\u62a5\u65f6\u95f4\u3002\n\n\n \u7d20\u6750\u7f29\u7565\u56fe\n \u622a\u56fe\u7f29\u7565\u56fe\uff0c\u70b9\u51fb\u53ef\u67e5\u770b\u622a\u56fe\u5927\u56fe\n\n\n \u7cfb\u7edf\u5e73\u53f0\n Android \/ iOS\n\n\n \u5e94\u7528\n \u5f00\u53d1\u8005\u5df2\u5728\u540e\u53f0\u521b\u5efa\u7684\u5e94\u7528\n\n\n \u5e7f\u544a\u4f4d\n \u6240\u9009\u5e94\u7528\u4e0b\u7684\u5e7f\u544a\u4f4d\n\n\n \u5e7f\u544a\u7c7b\u578b\n \u6240\u9009\u5e7f\u544a\u4f4d\u5e7f\u544a\u6837\u5f0f\u7c7b\u578b\n\n\n \u5e7f\u544a\u5e73\u53f0\n \u5e7f\u544a\u5e73\u53f0\u6e20\u9053\uff08\u5982 Pangle\u3001AdMob\u3001Mintegral \u7b49\uff09\n\n\n \u5e7f\u544a\u6e90\n \u5177\u4f53\u7684\u5e7f\u544a\u6e90\n\n\n \u8bbe\u5907 ID\n \u8bbe\u5907\u552f\u4e00\u6807\u8bc6\n\n\n Taku Request ID\n Taku \u53d1\u8d77\u5e7f\u544a\u52a0\u8f7d\u65f6\u7684\u8bf7\u6c42 ID\n\n\n \u5e7f\u544a\u5e73\u53f0 Creative ID\n \u5e7f\u544a\u5e73\u53f0\u4fa7\u7684\u7d20\u6750 ID\n\n\n \u8bf7\u6c42\u65f6\u95f4\n \u5e7f\u544a\u8bf7\u6c42\u53d1\u8d77\u65f6\u95f4\n\n\n \u586b\u5145\u65f6\u95f4\n \u5e7f\u544a\u586b\u5145\u83b7\u53d6\u65f6\u95f4\n\n\n \u5c55\u793a\u65f6\u95f4\n \u5e7f\u544a\u5c55\u793a \/ \u66dd\u5149\u65f6\u95f4\n\n\n\n2.3 \u4ee5\u56fe\u641c\u56fe\u529f\u80fd\n\u4ee5\u56fe\u641c\u56fe\u7528\u4e8e\u5728\u62e5\u6709\u4e00\u5f20\u5ba2\u8bc9\u622a\u56fe\u6216\u624b\u673a\u7ffb\u62cd\u7167\u7247\u65f6\uff0c\u5feb\u901f\u4ece\u5e73\u53f0\u5df2\u91c7\u96c6\u7684\u7d20\u6750\u5e93\u4e2d\u5339\u914d\u51fa\u6700\u76f8\u4f3c\u7684\u7d20\u6750\u8bb0\u5f55\uff0c\u4ece\u800c\u5b9a\u4f4d\u5e7f\u544a\u5e73\u53f0\u3001\u5e7f\u544a\u6e90\u548c\u8bbe\u5907\u3002\u5339\u914d\u7b97\u6cd5\u5bf9\u622a\u56fe\u88c1\u526a\u3001\u5206\u8fa8\u7387\u5dee\u5f02\u4ee5\u53ca\u624b\u673a\u7ffb\u62cd\u5f15\u5165\u7684\u6469\u5c14\u7eb9\u3001\u89d2\u5ea6\u504f\u79fb\u5177\u5907\u4e00\u5b9a\u5bb9\u5fcd\u5ea6\uff0c\u4f46\u4e3a\u4e86\u4fdd\u8bc1\u5339\u914d\u6210\u529f\u7387\uff0c\u5efa\u8bae\u5c3d\u91cf\u6309\u7167\u4ee5\u4e0b\u8981\u6c42\u8fdb\u884c\u62cd\u6444\uff1a\n\n\n\u62cd\u7167\u65f6\u5c06\u9700\u8981\u641c\u7d22\u7684\u5185\u5bb9\u586b\u6ee1\u6574\u4e2a\u753b\u9762\n\n\n\u5c3d\u91cf\u51cf\u5c11\u53cd\u5149\n\n\n\u50cf\u7d20\u5c3d\u91cf\u9ad8\n\n\n2.3.1 \u8fdb\u5165\u4ee5\u56fe\u641c\u56fe\u5165\u53e3\n\u5728\u5e7f\u544a\u63a2\u6d4b\u5668\u4e3b\u9875\u9762\u70b9\u51fb\u53f3\u4e0a\u65b9\u300c\u4ee5\u56fe\u641c\u56fe\u300d\u6309\u94ae\uff0c\u4f1a\u4ee5\u5f39\u7a97 \/ \u5b50\u9875\u9762\u7684\u5f62\u5f0f\u6253\u5f00\u56fe\u7247\u4e0a\u4f20\u754c\u9762\u3002\n\n\n2.3.2 \u4e0a\u4f20\u5f85\u5339\u914d\u56fe\u7247\n\u5728\u4e0a\u4f20\u533a\u57df\u9009\u62e9\u672c\u5730\u56fe\u7247\uff0c\u6216\u5c06\u56fe\u7247\u62d6\u62fd\u5230\u4e0a\u4f20\u6846\u5185\u3002\u652f\u6301\u7684\u683c\u5f0f\u4e3a JPG \/ PNG\uff0c\u5355\u5f20\u56fe\u7247\u5927\u5c0f\u4e0d\u8d85\u8fc7 5MB\uff0c\u65e2\u652f\u6301\u7cfb\u7edf\u622a\u56fe\u4e5f\u652f\u6301\u624b\u673a\u62cd\u7167\u5f97\u5230\u7684\u7167\u7247\u3002 \n2.3.3 \u67e5\u770b\u5339\u914d\u7ed3\u679c\n\u5339\u914d\u5b8c\u6210\u540e\u4f1a\u8fd4\u56de\u7ed3\u679c\u9875\u3002\u7ed3\u679c\u9875\u4f1a\u81ea\u52a8\u6e05\u9664\u4e3b\u9875\u9762\u7684\u5176\u4ed6\u7b5b\u9009\u9879\uff0c\u4ec5\u5c55\u793a\u4e0e\u672c\u6b21\u641c\u7d22\u76f8\u5173\u7684\u7d20\u6750\uff1a\n\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u6240\u6709\u5339\u914d\u5ea6\u4e3a 100% \u7684\u7d20\u6750\uff08\u5373\u4e0e\u4e0a\u4f20\u56fe\u7247\u9ad8\u5ea6\u4e00\u81f4\u7684\u7559\u5b58\u622a\u56fe\uff09\u3002\n\n\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u82e5\u4e0d\u8db3\u65f6\uff0c\u4f1a\u8865\u5145\u5339\u914d\u5ea6\u672a\u5230 100% \u7684\u76f8\u4f3c\u7d20\u6750\uff0c\u6574\u4f53\u8fd4\u56de \u5339\u914d\u5ea6Top 3~5 \u5f20\u5019\u9009\u622a\u56fe\u3002\n\n\n\u7ed3\u679c\u4ee5\u5217\u8868\u5f62\u5f0f\u5c55\u793a\uff0c\u5b57\u6bb5\u4e0e\u300c\u7d20\u6750\u6536\u96c6\u5c55\u793a\u300d\u4e2d\u7684\u6570\u636e\u5217\u8868\u5b8c\u5168\u4e00\u81f4\uff0c\u5305\u62ec\u7f29\u7565\u56fe\u3001\u5e7f\u544a\u5e73\u53f0\u3001\u5e7f\u544a\u6e90\u3001\u8bbe\u5907 ID\u3001\u5404\u7c7b\u65f6\u95f4\u6233\u7b49\u3002\u70b9\u51fb\u7f29\u7565\u56fe\u540c\u6837\u53ef\u67e5\u770b\u622a\u56fe\u8be6\u60c5\u3002\n\n2.3.4 \u5e38\u89c1\u95ee\u9898\n\n\n\n \u95ee\u9898\n \u8bf4\u660e \/ \u5904\u7406\u5efa\u8bae\n\n\n \u4e0a\u4f20\u56fe\u7247\u63d0\u793a\u6587\u4ef6\u8fc7\u5927\n \u68c0\u67e5\u56fe\u7247\u662f\u5426\u8d85\u8fc7 5MB\uff0c\u53ef\u4f7f\u7528\u622a\u56fe\u5de5\u5177\u6216\u56fe\u7247\u538b\u7f29\u540e\u518d\u4e0a\u4f20\u3002\n\n\n \u4e0a\u4f20\u56fe\u7247\u63d0\u793a\u683c\u5f0f\u4e0d\u652f\u6301\n \u5f53\u524d\u4ec5\u652f\u6301 JPG \/ PNG \u683c\u5f0f\uff0c\u8bf7\u5148\u8f6c\u6362\u683c\u5f0f\u3002\n\n\n \u641c\u7d22\u7ed3\u679c\u4e3a\u7a7a\u6216\u5339\u914d\u5ea6\u666e\u904d\u504f\u4f4e\n \u53ef\u80fd\u539f\u56e0\uff1a(1) \u8be5\u7d20\u6750\u672a\u88ab\u91c7\u96c6\uff08\u5bf9\u5e94\u5e94\u7528 \/ \u5e7f\u544a\u5e73\u53f0 \/ \u5e7f\u544a\u6837\u5f0f\u672a\u542f\u7528\u76d1\u6d4b\uff09\uff1b(2) \u5df2\u8d85\u8fc7\u7d20\u6750\u5b58\u50a8\u5468\u671f\uff1b(3) \u5ba2\u8bc9\u56fe\u7247\u4e0e\u539f\u59cb\u5c55\u793a\u753b\u9762\u5dee\u5f02\u8fc7\u5927\uff08\u4f8b\u5982\u4e8c\u6b21\u7f16\u8f91\u3001\u88c1\u5207\u8fc7\u591a\uff09\u3002\n\n\n \u540c\u4e00\u5f20\u56fe\u8fd4\u56de\u591a\u6761 100% \u5339\u914d\u8bb0\u5f55\n \u5c5e\u4e8e\u6b63\u5e38\u73b0\u8c61\u2014\u2014\u8be5\u7d20\u6750\u5728\u4e0d\u540c\u8bbe\u5907 \/ \u4e0d\u540c\u65f6\u95f4\u88ab\u591a\u6b21\u5c55\u793a\uff0c\u5206\u522b\u7559\u5b58\u4e86\u72ec\u7acb\u7684\u5c55\u793a\u8bb0\u5f55\uff0c\u53ef\u636e\u6b64\u8fdb\u4e00\u6b65\u5b9a\u4f4d\u5177\u4f53\u8bbe\u5907\u3002\n\n\n\n\u00a0","is_draft":"0","editor_type":"3","file_path":"","add_time":"1782384398","update_time":"1782963958"},"pure_content":"\u4e00\u3001\u529f\u80fd\u6982\u8ff0\n\u5e7f\u544a\u63a2\u6d4b\u5668\u662f Taku \u5f00\u53d1\u8005\u540e\u53f0\u300c\u9ad8\u7ea7\u529f\u80fd\u300d\u4e0b\u7684\u80fd\u529b\u6a21\u5757\uff0c\u7528\u4e8e\u5c06\u5e7f\u544a\u5c55\u793a\u65f6\u7684\u7d20\u6750\u622a\u56fe\u4e0e\u5bf9\u5e94\u7684\u5e7f\u544a\u94fe\u8def\u4fe1\u606f\u7559\u5b58\u5230\u5e73\u53f0\uff0c\u4fbf\u4e8e\u5f00\u53d1\u8005\u5728\u4e8b\u540e\u901a\u8fc7\u591a\u7ef4\u5ea6\u7b5b\u9009\u6216\u4ee5\u56fe\u641c\u56fe\u7684\u65b9\u5f0f\u67e5\u8be2\u5df2\u5c55\u793a\u7684\u5e7f\u544a\u7d20\u6750\u3002\n\u529f\u80fd\u6784\u6210\n\n\n\n \u6a21\u5757\n \u8bf4\u660e\n\n\n \u7d20\u6750\u6536\u96c6\u5c55\u793a\n \u5c55\u793a\u5df2\u91c7\u96c6\u7684\u5e7f\u544a\u7d20\u6750\u5217\u8868\uff0c\u5e76\u67e5\u770b\u6bcf\u6761\u8bb0\u5f55\u5bf9\u5e94\u7684\u5e7f\u544a\u4e0e\u8bbe\u5907\u4fe1\u606f\u3002\n\n\n \u4ee5\u56fe\u641c\u56fe\n \u4e0a\u4f20\u4e00\u5f20\u56fe\u7247\uff0c\u7cfb\u7edf\u901a\u8fc7\u56fe\u7247\u7279\u5f81\u5339\u914d\u8fd4\u56de\u6700\u76f8\u4f3c\u7684\u5df2\u91c7\u96c6\u7d20\u6750\u53ca\u5176"},{"id":"853990","string_id":"mpsxlz0A","status":"1","parent_id":"853989","slug":"mpsxlz0A","order":"0","name":"\u5e7f\u544a\u7d20\u6750\u63a2\u6d4b-Android \u63a5\u5165\u8bf4\u660e","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1782963183","add_time":"1782962762","update_time":"1782963958","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"853990","content":"> - \u672c\u6587\u6863\u9762\u5411\u63a5\u5165\u5e7f\u544aSDK\u00a0\u7684\u5f00\u53d1\u8005\uff0c\u8bf4\u660e\u5982\u4f55\u5728\u5f00\u5c4f\/\u6a2a\u5e45\/\u539f\u751f\uff08\u6709\u5bb9\u5668\uff09 \u4e0e \u63d2\u5c4f\/\u6fc0\u52b1\u89c6\u9891\uff08\u65e0\u5bb9\u5668\uff09 \u4e24\u79cd\u573a\u666f\u4e0b\uff0c\u5728\u5c55\u793a\u56de\u8c03\u91cc\u5bf9\u5e7f\u544a\u753b\u9762\u505a\u622a\u5e27\uff0c\u7528\u4e8e\u7d20\u6750\u5f52\u6863\u3001\u62bd\u68c0\u6216\u4e0a\u62a5\u3002\u8bf7\u7ed3\u5408\u00a0\u5e7f\u544aSDK\u00a0\u7684\u5c55\u793a\u00a0API\u00a0\u4e0e\u56de\u8c03\uff0c\u4fbf\u4e8e\u76f4\u63a5\u843d\u5730\u5b9e\u73b0\u3002\n> - \u4e0b\u8f7d\u5730\u5740\uff1a[http:\/\/info.appsmartsite.com\/Material_monitor\/Android_MaterialMonitor.zip](http:\/\/info.appsmartsite.com\/Material_monitor\/Android_MaterialMonitor.zip)\n\n---\n\n## 1.\u00a0\u6a21\u5757\u80fd\u529b\n\n| \u80fd\u529b | \u8bf4\u660e |\n| --- | --- |\n| \u622a\u5e27 | \u5e7f\u544a\u00a0`View`\u3001\u5168\u5c4f\/overlay\u00a0\u9875\u9762\uff0c\u6216\u539f\u751f\u56fe\u7247\u00a0url-only\uff08`meta.image_url`\uff09\u2192\u00a0JPEG\uff08\u2264\u00a0\u53ef\u914d\u7f6e\u00a0KB\uff0curl-only\u00a0\u65e0\u672c\u5730\u6587\u4ef6\uff09 |\n| \u5143\u6570\u636e | `ATAdInfo`\u00a0+\u00a0\u4f60\u4f20\u5165\u7684\u00a0`AdTimingInput`\u00a0+\u00a0\u8bbe\u5907\u5b57\u6bb5\u00a0\u2192\u00a0`meta` |\n| \u4e0a\u62a5 | `POST\u00a0{baseUploadUrl}\/v1\/creative\/upload`\uff08`app_id`\u3001`sign`\u3001`meta`\u3001`image`\uff09 |\n| \u79bb\u7ebf\u961f\u5217 | SQLite\uff1b\u65e0\u7f51\u6216\u4f20\u8f93\u5c42\u5931\u8d25\u65f6\u5ef6\u540e\u91cd\u8bd5\uff08\u4e0d\u5360\u00a0`maxUploadAttempts`\u00a0\u8ba1\u6570\uff09\uff1b\u65e5\u914d\u989d\u8282\u6d41 |\n| \u9519\u8bef\u7801 | \u7aef\u4fa7\u00a06xxx\uff08\u00a78.1\uff09+\u00a0\u7f51\u5173\u00a00\u00a0\/\u00a01xxx\uff5e5xxx\uff08\u00a78.4\uff09 |\n\n---\n\n## 2.\u00a0Gradle\u00a0\u63a5\u5165\n\n### 2.1\u00a0\u4f5c\u4e3a\u6e90\u7801\u5b50\u6a21\u5757\uff08\u4e0e\u672c\u00a0Demo\u00a0\u76f8\u540c\uff09\n\n\u5728\u5bbf\u4e3b\u00a0`settings.gradle`\u00a0\u4e2d\u00a0`include\u00a0':material-monitor'`\uff0c\u5728\u00a0app\u00a0\u6a21\u5757\uff1a\n\n```gradle\ndependencies {\n implementation project(':material-monitor')\n \/\/ \u5e7f\u544a SDK \u4f9d\u8d56\u9700\u4fdd\u7559\uff0c\u4fdd\u8bc1\u8fd0\u884c\u65f6\u5b58\u5728 ATAdInfo\n}\n```\n\n\u5c06\u00a0`_core_.aar`\uff08\u6216\u4e0e\u4f60\u4eec\u7248\u672c\u4e00\u81f4\u7684\u00a0core\uff09\u653e\u5230\u00a0`material-monitor\/libs\/`\uff0c\u4e0e\u4ed3\u5e93\u4e2d\u00a0`material-monitor\/build.gradle`\u00a0\u7684\u00a0`compileOnly\u00a0fileTree(dir:\u00a0'libs')`\u00a0\u4e00\u81f4\u3002\n\n### 2.2\u00a0\u6743\u9650\u4e0e\u8981\u6c42\n\n* minSdkVersion\uff1a\u672c\u5e93\u00a0`build.gradle`\u00a0\u4e3a\u00a021\uff1b\u5bbf\u4e3b\u82e5\u66f4\u9ad8\u4ee5\u5bbf\u4e3b\u4e3a\u51c6\u3002\u00a0\n \n* Java\u00a08+\u3002\u00a0\n \n* \u7f51\u7edc\u6743\u9650\uff1a\u4e0a\u62a5\u9700\u5bbf\u4e3b\u5177\u5907\u00a0`INTERNET`\u3002\u6a21\u5757\u5df2\u58f0\u660e\u00a0`ACCESS_NETWORK_STATE`\uff08\u7528\u4e8e\u4e0a\u4f20\u524d\u00a0\u662f\u5426\u6709\u53ef\u7528\u5916\u7f51\u00a0\u7684\u9884\u68c0\uff1b\u5408\u5e76\u00a0manifest\u00a0\u540e\u7531\u7cfb\u7edf\u6388\u4e88\u300c\u67e5\u770b\u7f51\u7edc\u8fde\u63a5\u300d\u7c7b\u6743\u9650\uff09\u3002\u00a0\n \n ```plaintext\n \n \n \n \n <\/manifest>\n \n ```\n \n* Core\u00a0AAR\uff1a\u5c06\u00a0`_core_.aar`\uff08\u6216\u4e0e\u4f60\u4eec\u7248\u672c\u4e00\u81f4\u7684\u00a0core\uff09\u653e\u5230\u00a0`material-monitor\/libs\/`\uff0c\u4e0e\u4ed3\u5e93\u4e2d\u00a0`material-monitor\/build.gradle`\u00a0\u7684\u00a0`compileOnly\u00a0fileTree(dir:\u00a0'libs')`\u00a0\u4e00\u81f4\u3002\n \n\n---\n\n## 3.\u00a0\u521d\u59cb\u5316\n\n\u5728\u9996\u4e2a\u00a0`Activity.onCreate`\u00a0\u8c03\u7528\uff08\u5185\u90e8\u4f1a\u6ce8\u518c\u751f\u547d\u5468\u671f\u56de\u8c03\u4ee5\u8ddf\u8e2a\u524d\u53f0\u00a0Activity,\u00a0\u53c2\u8003demo\uff09\uff1a\n\n```java\nimport com.github.material.monitor.MaterialMonitor;\nimport com.github.material.monitor.MaterialMonitorConfig;\n\npublic class FirstActivity extends Activity {\n @Override\n public void onCreate() {\n super.onCreate();\n \/\/ \u5f00\u53d1\u8005\u7528\u6237\u534f\u8bae\u5141\u8bb8\u4e4b\u540e\u81ea\u884c\u83b7\u53d6\u548c\u586b\u5145\u8bbe\u5907\u4fe1\u606f\n MaterialMonitor.init(this, new MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-gateway-host\") \/\/ \u4e0a\u4f20\u5730\u5740\n .appId(\"YOUR_APP_ID\")\n .appKey(\"YOUR_APP_KEY\") \/\/ \u8bf7\u52ff\u6cc4\u6f0f\n .oaid(oaidString)\n .androidId(androidIdString)\n .gaid(gaidString)\n \/\/ .imei(...).mac(...)\n \/\/ .maxUploadAttempts(3)\n \/\/ .retryDelayMs(3000L, 10000L)\n \/\/ .connectTimeoutMs(15000).readTimeoutMs(30000)\n \/\/ .debugPerfLogging(BuildConfig.DEBUG)\n .build());\n }\n}\n```\n\n### 3.1\u00a0`MaterialMonitorConfig.Builder`\u00a0\u53c2\u6570\u4e00\u89c8\n\n\u7c7b\u8def\u5f84\uff1a`com.github.material.monitor.MaterialMonitorConfig`\u3002\u6784\u5efa\u540e\u53ef\u901a\u8fc7**\u00a0`MaterialMonitor.get().getConfig()`\u00a0\u8bfb\u53d6\uff1b`isUploadConfigured()`\\\\\u00a0\u5728\u00a0`baseUploadUrl`\u3001`appId`\u3001`appKey`\u00a0\u4e09\u8005\u5747\u975e\u7a7a\u65f6\u4e3a\u00a0`true`\uff08\u81ea\u52a8\u5165\u961f\u4e0a\u62a5\u7684\u524d\u7f6e\u6761\u4ef6\uff09\u3002\n\n| Builder\u00a0\u65b9\u6cd5 | \u9ed8\u8ba4 | \u5fc5\u586b\uff08\u4e0a\u62a5\uff09 | \u8bf4\u660e |\n| --- | --- | --- | --- |\n| `baseUploadUrl(String)` | `\"\"` | \u662f | \u7f51\u5173\u00a0\u6839\u5730\u5740\uff0c\u4ec5\u00a0host\uff08\u53ef\u5e26\u7aef\u53e3\uff09\uff0c\u4e0d\u542b\u8def\u5f84\u3002\u5ba2\u6237\u7aef\u4f1a\u62fc\u00a0`POST\u00a0{baseUploadUrl}\/v1\/creative\/upload`\u3002\u793a\u4f8b\uff1a`https:\/\/api.example.com\\`\u00a0\u6216\u6d4b\u8bd5\u73af\u5883\u00a0`http:\/\/dev12-cag.toponad.com\\`\u3002\u9996\u5c3e\u7a7a\u767d\u4f1a\u88ab\u00a0trim\u3002 |\n| `appId(String)` | `\"\"` | \u662f | TopOn\u00a0\u5f00\u53d1\u8005\u540e\u53f0\u5206\u914d\u7684\u00a0\u5e94\u7528\u00a0ID\uff0c\u7528\u4e8e\u00a0multipart\u00a0\u8868\u5355\u5b57\u6bb5\u00a0`app_id`\u00a0\u4e0e\u7b7e\u540d\u3002 |\n| `appKey(String)` | `\"\"` | \u662f | \u4e0e\u00a0`appId`\u00a0\u914d\u5bf9\u7684\u00a0\u7b7e\u540d\u5bc6\u94a5\uff08HMAC-MD5\uff0c\u89c1\u7f51\u5173\u6587\u6863\u00a0\u00a73\uff09\u3002\u52ff\u5199\u5165\u516c\u5f00\u4ed3\u5e93\u6216\u660e\u6587\u65e5\u5fd7\uff1b\u63a8\u8350\u8fdc\u7a0b\u4e0b\u53d1\u6216\u52a0\u56fa\u5b58\u50a8\u3002 |\n| `oaid(String)` | `\"\"` | \u5efa\u8bae | \u5199\u5165\u00a0`meta.device_info.oaid`\u3002Android\u00a0\u533f\u540d\u8bbe\u5907\u6807\u8bc6\uff1b\u987b\u5728\u00a0\u7528\u6237\u540c\u610f\u9690\u79c1\u540e\u00a0\u7531\u5bbf\u4e3b\u91c7\u96c6\u5e76\u4f20\u5165\u3002 |\n| `androidId(String)` | `\"\"` | \u53ef\u9009 | \u5199\u5165\u00a0`meta.device_info.android_id`\u3002 |\n| `gaid(String)` | `\"\"` | \u53ef\u9009 | Google\u00a0Advertising\u00a0ID\uff0c\u5199\u5165\u00a0`meta.device_info.gaid`\u3002 |\n| `imei(String)` | `\"\"` | \u53ef\u9009 | \u5199\u5165\u00a0`meta.device_info.imei`\uff1b\u53d7\u7cfb\u7edf\u7248\u672c\u4e0e\u6743\u9650\u9650\u5236\uff0c\u591a\u6570\u573a\u666f\u53ef\u4e0d\u4f20\u3002 |\n| `mac(String)` | `\"\"` | \u53ef\u9009 | \u5199\u5165\u00a0`meta.device_info.mac`\uff1b\u5408\u89c4\u4e0a\u901a\u5e38\u00a0\u4e0d\u5efa\u8bae\u00a0\u91c7\u96c6\u3002 |\n| `maxUploadAttempts(int)` | `3` | \u5426 | \u542b\u9996\u6b21\u8bf7\u6c42\u00a0\u7684\u5355\u4efb\u52a1\u6700\u5927\u4e0a\u4f20\u6b21\u6570\uff08`3`\u00a0=\u00a01\u00a0\u6b21\u9996\u53d1\u00a0+\u00a0\u6700\u591a\u00a02\u00a0\u6b21\u91cd\u8bd5\uff09\u3002\u4ec5\u5bf9\u00a0\u7f51\u5173\u53ef\u91cd\u8bd5\u5931\u8d25\uff08\u5982\u00a04xxx\/5xxx\uff09\u8ba1\u6570\uff1b\u65e0\u7f51\u5ef6\u540e\uff086006\uff09\u4e0d\u5360\u6b64\u9884\u7b97\uff08\u00a79.2\uff09\u3002\u8017\u5c3d\u00a0\u2192\u00a0`RETRY_EXHAUSTED`\uff086007\uff09\u3002\u6700\u5c0f\u503c\u4e3a\u00a0`1`\u3002 |\n| `retryDelayMs(long\u00a0firstMs,\u00a0long\u00a0secondMs)` | `5000`,\u00a0`15000` | \u5426 | \u7b2c\u00a01\u30012\u00a0\u6b21\u00a0\u53ef\u91cd\u8bd5\u5931\u8d25\u00a0\u540e\u7684\u7b49\u5f85\u6beb\u79d2\u6570\uff1b\u7b2c\u00a03\u00a0\u6b21\u53ca\u4ee5\u540e\u5931\u8d25\u00a0\u590d\u7528\u00a0`secondMs`\u3002\u4e0e\u00a0`4001`\u00a0\u9650\u6d41\u65f6\u00a0SDK\u00a0\u4f1a\u53d6\u00a0`max(\u914d\u7f6e\u5ef6\u8fdf,\u00a01s)`\u3002 |\n| `connectTimeoutMs(int)` | `15000` | \u5426 | `HttpURLConnection`\u00a0\u8fde\u63a5\u8d85\u65f6\uff08\u6beb\u79d2\uff09\uff0c\u5185\u90e8\u00a0\u4e0b\u9650\u00a03000\u3002 |\n| `readTimeoutMs(int)` | `30000` | \u5426 | `HttpURLConnection`\u00a0\u8bfb\u8d85\u65f6\uff08\u6beb\u79d2\uff09\uff0c\u5185\u90e8\u00a0\u4e0b\u9650\u00a03000\u3002 |\n| `debugPerfLogging(boolean)` | `false` | \u5426 | \u4e3a\u00a0`true`\u00a0\u65f6\u8f93\u51fa\u00a0`[frame]`\u00a0\/\u00a0`[bitmap]`\u00a0\/\u00a0`[storage]`\u00a0\/\u00a0`[upload]`\u00a0\u7b49\u5206\u9636\u6bb5\u8017\u65f6\uff08Logcat\u00a0tag\u00a0\u542b\u00a0`MaterialLog@`\u00a0+\u00a0\u6a21\u5757\u7248\u672c\uff09\uff0c\u8054\u8c03\u6027\u80fd\u7528\uff1bRelease\u00a0\u5efa\u8bae\u5173\u95ed\u3002 |\n\n\u4ec5\u91c7\u96c6\u3001\u4e0d\u4e0a\u4f20\uff1a\u53ef`MaterialMonitor.init(this)`\u00a0\u5219\u4f7f\u7528\u9ed8\u8ba4\u7a7a\u914d\u7f6e\uff1b\u6b64\u65f6\u81ea\u52a8\u5165\u961f\u00a0\/\u00a0`reportFrameRecord`\u00a0\u4f1a\u56e0\u672a\u914d\u7f6e\u5b8c\u6574\u4e0a\u4f20\u53c2\u6570\u800c\u5f97\u5230\u00a0`ErrorCodes.NOT_READY`\uff08\u89c1\u00a0\u00a78\uff09\u3002\n\n---\n\n## 4.\u00a0\u4f55\u65f6\u8c03\u7528\u3001delayMs\u00a0\u5efa\u8bae\u4e0e\u7279\u6b8a\u573a\u666f\n\n### 4.1\u00a0\u901a\u7528\u539f\u5219\n\n\u5728\u00a0\u5e7f\u544a\u5df2\u5c55\u793a\u3001\u76ee\u6807\u533a\u57df\u5df2\u00a0layout\u00a0\u5b8c\u6210\u00a0\u4e14\u4ecd\u00a0attached\u00a0\u7684\u56de\u8c03\u91cc\u8c03\u7528\uff08\u5982\u00a0`onAdShow`\u3001Banner\u00a0\u5c55\u793a\u56de\u8c03\u3001\u539f\u751f\u7ed1\u5b9a\u6570\u636e\u540e\uff09\u3002 \n`FrameOptions.delayMs`\u00a0\u8868\u793a\uff1a\u4ece\u8c03\u7528\u65f6\u523b\u8d77\u518d\u7b49\u5f85\u591a\u5c11\u6beb\u79d2\u00a0\u624d\u771f\u6b63\u622a\u5c4f\uff0c\u7528\u4e8e\u9519\u5f00\u767d\u5c4f\u3001\u7d20\u6750\u6216\u89c6\u9891\u9996\u5e27\u672a\u5c31\u7eea\u3001\u5f31\u7f51\u52a0\u8f7d\u6162\u7b49\u60c5\u51b5\u3002\n\n### 4.2\u00a0\u56e0\u7f51\u7edc\u4e0e\u7d20\u6750\u52a0\u8f7d\u7684\u5ef6\u8fdf\u5efa\u8bae\uff08\u63a8\u8350\u9ed8\u8ba4\u503c\uff09\n\n\u7ed3\u5408\u5f31\u7f51\u4e0b\u89c6\u9891\u7c7b\u7d20\u6750\u7f13\u51b2\u66f4\u6162\u3001\u9759\u6001\u6216\u00a0HTML\u00a0\u7c7b\u76f8\u5bf9\u66f4\u5feb\u7684\u5dee\u5f02\uff0c\u5efa\u8bae\u5982\u4e0b\uff08\u53ef\u5728\u8fdc\u7a0b\u914d\u7f6e\u4e2d\u4e0b\u53d1\uff0c\u6309\u6d41\u91cf\u5206\u5c42\u5fae\u8c03\uff09\uff1a\n\n| \u5e7f\u544a\u6837\u5f0f | \u5efa\u8bae\u00a0`delayMs` | \u8bf4\u660e |\n| --- | --- | --- |\n| \u6fc0\u52b1\u89c6\u9891 | 3000\uff5e5000\u00a0ms | \u89c6\u9891\u6d41\u4e0e\u8d34\u7247\u5e38\u53d7\u7f51\u7edc\u5f71\u54cd\uff0c\u8fc7\u77ed\u6613\u9ed1\u5c4f\u6216\u672a\u89e3\u7801\u5e27\uff1b\u53ef\u4ece\u00a02s\u00a0\u8d77\u7ebf\u4e0a\u89c2\u5bdf\u5b8c\u6574\u7387\uff0c\u5fc5\u8981\u65f6\u63d0\u5230\u00a03\uff5e5s |\n| \u5f00\u5c4f\u00a0\/\u00a0Banner\u00a0\/\u00a0\u63d2\u5c4f\u00a0\/\u00a0\u539f\u751f\u7b49\u975e\u6fc0\u52b1 | \u7ea6\u00a02000\u00a0ms | \u76f8\u5bf9\u6fc0\u52b1\u89c6\u9891\u5bf9\u300c\u9996\u5e27\u5c31\u7eea\u300d\u8981\u6c42\u7565\u4f4e\uff0c2\u00a0\u79d2\u5728\u591a\u6570\u673a\u578b\u4e0e\u7f51\u7edc\u4e0a\u53ef\u517c\u987e\u5408\u89c4\u753b\u9762\u4e0e\u4f53\u9a8c |\n\n\u4ee5\u4e0a\u9488\u5bf9\u300c\u5355\u6b21\u5c55\u793a\u53ea\u622a\u4e00\u5e27\u300d\u7684\u5e38\u89c4\u76d1\u6d4b\uff1b\u4e0e\u00a0\u00a74.3\u00a0\u7684\u300c\u6fc0\u52b1\u5173\u95ed\u524d\u591a\u5e27\u300d\u53ef\u7ec4\u5408\u4f7f\u7528\u3002\n\n### 4.3\u00a0\u6fc0\u52b1\u89c6\u9891\uff1a\u5173\u95ed\u524d\u6309\u9700\u00a00\u00a0\u5ef6\u65f6\u3001\u95f4\u9694\u591a\u5e27\n\n\u4e3a\u66f4\u51c6\u786e\u8bc6\u522b\u00a0\u8fdd\u89c4\u753b\u9762\u3001\u5f02\u5e38\u8df3\u8f6c\u3001\u7ed3\u675f\u5e27\u8bf1\u5bfc\u00a0\u7b49\uff0c\u53ef\u5728\u00a0\u5e7f\u544a\u5373\u5c06\u5173\u95ed\u6216\u7528\u6237\u5373\u5c06\u79bb\u5f00\u00a0\u524d\uff0c\u5728\u00a0\u753b\u9762\u5df2\u7a33\u5b9a\u53ef\u89c1\u00a0\u7684\u8282\u70b9\u4e0a\uff0c\u4f7f\u7528\u00a0`delayMs(0)`\u00a0\u505a\u00a0\u5373\u65f6\u622a\u5e27\uff0c\u5e76\u6309\u4e1a\u52a1\u95f4\u9694\u00a0\u591a\u6b21\u8c03\u7528\uff08\u4f8b\u5982\u6bcf\u9694\u00a05\u00a0\u79d2\u4e00\u6b21\uff0c\u6216\u5728\u00a0`onReward`\u3001`onClose`\u00a0\u524d\u4e00\u523b\u5404\u4e00\u6b21\uff09\u3002\n\n\u6ce8\u610f**\uff1a\n\n* `delayMs(0)`\u00a0\u8868\u793a\u00a0\u4e0d\u989d\u5916\u7b49\u5f85\uff0c\u4ecd\u8981\u6c42\u8c03\u7528\u65f6\u00a0`View`\u00a0\u5df2\u00a0layout\u00a0\u4e14\u00a0\u4ecd\u9644\u7740\u5728\u7a97\u53e3\u4e0a\uff1b\u82e5\u8c03\u7528\u8fc7\u65e9\u4ecd\u53ef\u80fd\u5931\u8d25\uff08`VIEW_INVALID`\u00a0\/\u00a0\u9ed1\u5e27\uff09\uff0c\u8bf7\u628a\u300c0\u00a0\u5ef6\u65f6\u8c03\u7528\u300d\u653e\u5728\u00a0\u751f\u547d\u5468\u671f\u9760\u540e\u3001\u5185\u5bb9\u5df2\u5c55\u793a\u00a0\u7684\u56de\u8c03\u91cc\u3002\u00a0\n \n* \u6bcf\u4e00\u6b21\u00a0`collectFrameFrom*`\u00a0\u90fd\u4f1a\u751f\u6210\u00a0\u65b0\u7684\u00a0`FrameRecord.uploadTaskId`\uff08\u961f\u5217\u5e42\u7b49\u952e\uff09\uff0c\u540c\u4e00\u5e7f\u544a\u5c55\u793a\u53ef\u591a\u6b21\u622a\u5e27\u3001\u591a\u6b21\u4e0a\u62a5\uff1b\u7f51\u5173\u4fa7\u5c55\u793a\u7ef4\u5ea6\u4ecd\u4ee5\u00a0`**ATAdInfo.getShowId()`\u00a0\u7b49\u4e0e\u00a0`meta.event_info`\u00a0\u4e00\u81f4\u3002\u00a0\n \n* \u591a\u5e27\u4f1a\u589e\u52a0\u00a0\u6d41\u91cf\u3001\u961f\u5217\u957f\u5ea6\u4e0e\u65e5\u914d\u989d\u00a0\u6d88\u8017\uff0c\u8bf7\u4e0e\u4ea7\u54c1\/\u5408\u89c4\u7ea6\u5b9a\u00a0\u9891\u6b21\u4e0a\u9650\u3002\u82e5\u6709\u591a\u5e27\u622a\u53d6\u9700\u6c42\uff0c\u5efa\u8bae5\u79d2\u4e00\u6b21\uff0c\u6309\u6700\u957f\u8fb9\u50cf\u7d20\uff08`maxLongEdge`\uff091080\u6807\u51c6\uff1b\u82e5\u6709\u9ad8\u9891\u9700\u6c42\uff0c\u5219\u9700\u964d\u4f4e`maxLongEdge`\u6807\u51c6\u5982720\u3001540\uff1b\u9ad8\u9891\u622a\u5e27\u52a8\u4f5c\u4f1a\u589e\u52a0ANR\u6216\u5185\u5b58\u4e0a\u6da8\u8fc7\u9ad8\u98ce\u9669\u3002\n \n\n\u793a\u4f8b\uff08\u4f2a\u4ee3\u7801\uff1a\u5728\u6fc0\u52b1\u5173\u95ed\u524d\u77ed\u95f4\u9694\u518d\u91c7\u4e00\u5e27\uff0c`delayMs`\u00a0\u4e3a\u00a00\uff09\uff1a\n\n```java\nFrameOptions urgent = new FrameOptions.Builder().delayMs(0).maxSizeKb(300).build();\nMaterialMonitor.get().collectFrameFromAdContainer(rewardContainer, adInfo, timing, urgent, callback);\n```\n\n### 4.4\u00a0\u539f\u751f\u81ea\u6e32\u67d3\uff1a\u6309\u7d20\u6750\u7c7b\u578b\u9009\u62e9\u91c7\u96c6\u00a0API\n\n\u539f\u751f\u81ea\u6e32\u67d3\u5e7f\u544a\u8bf7\u6309\u00a0\u4e3b\u7d20\u6750\u7c7b\u578b\u00a0\u9009\u7528\u00a0API\uff08Demo\u00a0\u53c2\u8003\u00a0`NativeAdActivity`\u00a0\u56fe\u7247\u3001`NativePatchVideoActivity`\u00a0\u89c6\u9891\uff09\uff1a\n\n| \u7d20\u6750\u7c7b\u578b | \u63a8\u8350\u00a0API | \u8bf4\u660e |\n| --- | --- | --- |\n| \u56fe\u7247\uff08\u9759\u6001\u5927\u56fe\u7b49\uff09 | `collectFrameFromNativeAdContainer` | \u4f20\u5165\u6709\u6548\u00a0`http`\/`https`\u00a0\u7684\u00a0`creativeAssetUrl`\uff08\u5982\u00a0`getAdMaterial().getMainImageUrl()`\uff09\u65f6\uff0c\u8df3\u8fc7\u672c\u5730\u622a\u5c4f\uff0c\u4ec5\u4e0a\u62a5\u00a0`meta.image_url`\uff08\u7f51\u5173\u00a0url-only\u00a0\u8def\u5f84\uff09\uff1b\u65e0\u6548\u6216\u975e\u00a0http(s)\u00a0URL\u00a0\u4f1a\u00a0\u56de\u9000\u00a0\u4e3a\u5bf9\u00a0`targetView`\u00a0\u622a\u5c4f |\n| \u89c6\u9891 | `collectFrameFromAdContainer` | \u89c6\u9891\u5e27\u5728\u00a0`SurfaceView`\u00a0\/\u00a0\u786c\u4ef6\u5c42\uff0c\u9700\u8d70\u5bb9\u5668\u622a\u5c4f\u00a0+\u00a0`PixelCopy`\uff1b\u4e0d\u8981\u4f9d\u8d56\u9759\u6001\u4e3b\u56fe\u00a0URL |\n\n* `creativeAssetUrl`\uff1a\u56fe\u7247\u573a\u666f\u00a0\u6709\u5219\u4f20\uff1b\u987b\u4e3a\u00a0`http:\/\/`\u00a0\u6216\u00a0`https:\/\/`\u00a0\u5f00\u5934\u3002\u7a7a\u767d\u6216\u975e\u6cd5\u534f\u8bae\u4e0d\u4f1a\u5931\u8d25\u6574\u6b21\u8c03\u7528\uff0c\u800c\u662f\u56de\u9000\u4e3a\u622a\u5c4f\u3002\u00a0\n \n* url-only\u00a0\u6210\u529f\u65f6\u00a0`FrameRecord.file`\u00a0\u4e3a\u00a0`null`\uff0cmultipart\u00a0\u4e0d\u542b\u00a0`image`\u00a0part\uff1b\u5177\u4f53\u5fc5\u586b\u89c4\u5219\u4ee5\u7f51\u5173\u6587\u6863\u4e3a\u51c6\u3002\n \n\n---\n\n## 5.\u00a0API\u00a0\u53c2\u8003\uff08\u5165\u53c2\u3001\u8fd4\u56de\u503c\u4e0e\u7528\u6cd5\uff09\n\n\u5305\u540d\uff1a`com.github.material.monitor`\u3002\u4ee5\u4e0b\u82e5\u65e0\u8bf4\u660e\uff0c\u91c7\u96c6\u76f8\u5173\u56de\u8c03\u5747\u5728\u4e3b\u7ebf\u7a0b\uff08\u89c1\u5bf9\u5916\u5b9e\u65bd\u65b9\u6848\u4e2d\u7684\u7ebf\u7a0b\u8bf4\u660e\uff09\u3002\n\n### 5.1\u00a0`MaterialMonitor.init`\u00a0\/\u00a0`get`\u00a0\/\u00a0`getConfig`\n\n| \u65b9\u6cd5 | \u8bf4\u660e |\n| --- | --- |\n| `static\u00a0void\u00a0init(Application\u00a0application)` | \u4f7f\u7528\u9ed8\u8ba4\u00a0`MaterialMonitorConfig`\uff08\u65e0\u4e0a\u4f20\u53c2\u6570\uff09\u3002\u4ec5\u9002\u5408\u53ea\u843d\u76d8\u3001\u4e0d\u63a5\u7f51\u5173\u7684\u573a\u666f\u3002 |\n| `static\u00a0void\u00a0init(Application\u00a0application,\u00a0MaterialMonitorConfig\u00a0config)` | \u63a8\u8350\u3002`config`\u00a0\u4e0d\u53ef\u4e3a\u00a0null\u00a0\u65f6\u7528\u00a0`DEFAULT`\u00a0\u7b49\u4ef7\u7a7a\u914d\u7f6e\u3002 |\n| `static\u00a0MaterialMonitor\u00a0get()` | \u83b7\u53d6\u5355\u4f8b\u3002\u672a\u00a0`init`\u00a0\u6216\u5df2\u00a0`shutdown`\u00a0\u65f6\u8fd4\u56de\u00a0idle\u00a0\u5360\u4f4d\u5b9e\u4f8b\uff08`collect`\u00a0\u7b49\u4e3a\u00a0no-op\u00a0\u5e76\u6253\u00a0warn\u00a0\u65e5\u5fd7\uff09\uff0c\u4e0d\u629b\u5f02\u5e38\u3002 |\n| `static\u00a0boolean\u00a0isReady()` | \u662f\u5426\u5df2\u00a0`init`\u00a0\u4e14\u5c1a\u672a\u00a0`shutdown`\uff08\u771f\u5b9e\u5b9e\u4f8b\u53ef\u5728\u9996\u6b21\u00a0`get()`\u00a0\u65f6\u61d2\u521b\u5efa\uff09\u3002 |\n| `static\u00a0void\u00a0shutdown()` | \u91ca\u653e\u751f\u547d\u5468\u671f\u56de\u8c03\u4e0e\u00a0worker\uff1b\u5f85\u4e0a\u4f20\u00a0SQLite\u00a0\u884c\u4fdd\u7559\uff0c\u540e\u7eed\u53ef\u518d\u6b21\u00a0`init`\u00a0\u7eed\u4f20\u3002 |\n| `MaterialMonitorConfig\u00a0getConfig()` | \u8bfb\u53d6\u521d\u59cb\u5316\u65f6\u7684\u914d\u7f6e\uff1b\u53ef\u8c03\u7528\u00a0`isUploadConfigured()`\u00a0\u5224\u65ad\u662f\u5426\u5177\u5907\u00a0`baseUploadUrl\u00a0+\u00a0appId\u00a0+\u00a0appKey`\u3002 |\n\n### 5.2\u00a0`collectFrameFromAdContainer`\n\n\u7b7e\u540d\n\n```text\nvoid collectFrameFromAdContainer(\n View targetView,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n FrameCallback callback\n)\n```\n\n| \u53c2\u6570 | \u7c7b\u578b | \u53ef\u5426\u00a0null | \u8bf4\u660e |\n| --- | --- | --- | --- |\n| `targetView` | `View` | \u5426 | \u5e7f\u544a\u5b9e\u9645\u6e32\u67d3\u533a\u57df\uff08\u5bb9\u5668\uff09\u3002\u5ef6\u65f6\u7ed3\u675f\u540e\u4f1a\u68c0\u67e5\u00a0\u4ecd\u00a0attached\uff1b\u5ef6\u65f6\u671f\u95f4\u4ec5\u00a0\u5f31\u5f15\u7528\u6301\u6709\uff0c\u907f\u514d\u6cc4\u6f0f\u3002 |\n| `adInfo` | `ATAdInfo` | \u5426 | \u5f53\u524d\u5c55\u793a\u5bf9\u5e94\u7684\u00a0TopOn\u00a0\u5e7f\u544a\u4fe1\u606f\uff0c\u7528\u4e8e\u00a0`placementId`\u3001`showId`\u3001\u6837\u5f0f\u679a\u4e3e\u00a0`MaterialStyle`\u7b49\u3002 |\n| `timing` | `AdTimingInput` | \u5426 | \u8bf7\u6c42\/\u586b\u5145\/\u5c55\u793a\u65f6\u95f4\uff08\u6beb\u79d2\uff09\uff0c\u5199\u5165\u7f51\u5173\u00a0`event_info`\uff08\u5e93\u5185\u8f6c\u79d2\uff09\u3002 |\n| `options` | `FrameOptions` | \u53ef | \u4f20\u00a0`null`\u00a0\u65f6\u4f7f\u7528\u00a0`FrameOptions.defaults()`\u3002 |\n| `callback` | `FrameCallback` | \u53ef | \u4f20\u00a0`null`\u00a0\u65f6\u65e0\u91c7\u96c6\/\u4e0a\u62a5\u56de\u8c03\uff0c\u4e00\u822c\u4e0d\u63a8\u8350\u3002 |\n\n\u884c\u4e3a\uff1a\u6821\u9a8c\u901a\u8fc7\u540e\u00a0`postDelayed(delayMs)`\uff0c\u5230\u65f6\u622a\u5c4f\u00a0\u2192\u00a0\u538b\u7f29\u5199\u76d8\u00a0\u2192\u00a0\u4e3b\u7ebf\u7a0b\u00a0`onCollectSuccess`\u00a0\u2192\u00a0\u82e5\u4e0a\u4f20\u5df2\u914d\u7f6e\u5219\u00a0\u81ea\u52a8\u00a0`enqueueReport`\u3002\u5931\u8d25\u8d70\u00a0`onCollectFailure`\uff08\u4e0d\u4f1a\u5165\u961f\uff09\u3002\n\n\u6837\u5f0f\u76ee\u5f55\uff1a`MaterialStyle`\u00a0\u7531\u5185\u90e8\u6839\u636e\u00a0`ATAdInfo`\u00a0\u89e3\u6790\uff0c\u7528\u4e8e\u672c\u5730\u5b50\u76ee\u5f55\u540d\uff08\u5982\u00a0`rewarded_video`\uff09\uff0c\u4e0e\u7f51\u5173\u00a0`ad_type`\u00a0\u542b\u4e49\u5bf9\u5e94\uff0c\u65e0\u9700\u8c03\u7528\u65b9\u4f20\u5165\u3002\n\n### 5.3\u00a0`collectFrameFromNativeAdContainer`\n\n\u7b7e\u540d\n\n```text\nvoid collectFrameFromNativeAdContainer(\n View targetView,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n String creativeAssetUrl,\n FrameCallback callback\n)\n```\n\n| \u53c2\u6570 | \u7c7b\u578b | \u53ef\u5426\u00a0null | \u8bf4\u660e |\n| --- | --- | --- | --- |\n| `targetView`\u00a0\/\u00a0`adInfo`\u00a0\/\u00a0`timing`\/\u00a0`options`\u00a0\/\u00a0`callback` | \u540c\u4e0a | \u540c\u4e0a | \u4e0e\u00a0`collectFrameFromAdContainer`\u00a0\u4e00\u81f4\u3002 |\n| `creativeAssetUrl` | `String` | \u53ef\u7a7a\u5b57\u7b26\u4e32 | \u6709\u6548\u00a0`http`\/`https`\u00a0URL\u00a0\u5199\u5165\u00a0`FrameRecord.imageUrl`\u00a0\u4e0e\u00a0`meta.image_url`\uff0c\u5e76\u8d70\u00a0url-only\u00a0\u4e0a\u62a5\uff08\u4e0d\u622a\u5c4f\u3001\u4e0d\u5199\u00a0JPEG\uff09\u3002\u7a7a\u767d\u6216\u975e\u6cd5\u534f\u8bae\u00a0\u56de\u9000\u00a0\u4e3a\u5bf9\u00a0`targetView`\u00a0\u622a\u5c4f\uff08\u4e0e\u00a0`collectFrameFromAdContainer`\u00a0\u76f8\u540c\uff09\u3002 |\n\n\u884c\u4e3a\uff1a\u6709\u6548\u00a0URL\u00a0\u65f6\u5ef6\u65f6\u7ed3\u675f\u540e\u76f4\u63a5\u00a0`onCollectSuccess`\uff08`file\u00a0==\u00a0null`\uff09\u5e76\u5165\u961f\u00a0url-only\u00a0\u4e0a\u62a5\uff1b\u56de\u9000\u8def\u5f84\u4e0e\u5bb9\u5668\u622a\u5c4f\u4e00\u81f4\u3002\n\n### 5.4\u00a0`collectFrameFromAdPage`\n\n\u7b7e\u540d\n\n```text\nvoid collectFrameFromAdPage(\n Activity hostActivity,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n FrameCallback callback\n)\n```\n\n| \u53c2\u6570 | \u7c7b\u578b | \u53ef\u5426\u00a0null | \u8bf4\u660e |\n| --- | --- | --- | --- |\n| `hostActivity` | `Activity` | \u5426 | \u8c03\u7528\u65b9\u00a0\u5f53\u524d\u9875\u9762\uff08\u5c55\u793a\u5e7f\u544a\u524d\/\u627f\u8f7d\u56de\u8c03\u7684\u00a0Activity\uff0c\u5982\u00a0Demo\u00a0\u9875\uff09\u3002\u7528\u4e8e\u5728\u5ef6\u65f6\u622a\u5c4f\u65f6\u00a0\u6392\u9664\u00a0\u8be5\u7a97\u53e3\uff0c\u907f\u514d\u900f\u660e\u00a0overlay\u00a0\u6216\u72ec\u7acb\u00a0`AdActivity`\u00a0\u573a\u666f\u8bef\u622a\u5230\u5bbf\u4e3b\u9875\u3002\u65e0\u6548\uff08null\u00a0\/\u00a0finishing\u00a0\/\u00a0destroyed\uff09\u2192\u00a0`PARAM_INVALID`\u3002 |\n| `adInfo`\u00a0\/\u00a0`timing`\/\u00a0`options`\u00a0\/\u00a0`callback` | \u540c\u4e0a | \u540c\u4e0a | \u4e0e\u5bb9\u5668\u91c7\u96c6\u4e00\u81f4\u3002 |\n\n\u5ef6\u65f6\u540e\u7684\u6355\u83b7\u76ee\u6807\uff08\u6309\u4f18\u5148\u7ea7\uff09\uff1a\n\n1. \u5f53\u524d\u00a0\u524d\u53f0\u00a0resumed\u00a0Activity\uff08\u5e38\u4e3a\u00a0SDK\u00a0\u72ec\u7acb\u5e7f\u544a\u9875\uff09\uff1b\n \n2. \u5426\u5219\u56de\u9000\u5230\u00a0pin\u00a0\u4f4f\u7684\u00a0`hostActivity`\uff1b\n \n3. \u901a\u8fc7\u00a0`HostOverlayViewLocator`\u00a0\u89e3\u6790\u00a0Dialog\u00a0\/\u00a0\u72ec\u7acb\u00a0Window\u00a0\/\u00a0decor\u00a0\u9876\u5c42\u00a0overlay\uff0c\u800c\u975e\u7b80\u5355\u53d6\u00a0`android.R.id.content`\u3002\n \n\n\u9002\u7528\uff1a\u63d2\u5c4f\/\u6fc0\u52b1\u7b49\u00a0\u65e0\u7a33\u5b9a\u4e1a\u52a1\u4fa7\u5e7f\u544a\u5bb9\u5668\u3001\u6216\u5168\u5c4f\u8986\u76d6\u96be\u4ee5\u53d6\u5b50\u00a0`View`\u00a0\u65f6\uff08Demo\uff1a`InterstitialAdActivity`\u3001`RewardVideoAdActivity`\u00a0\u4f20\u5165\u00a0`this`\uff09\u3002 \n\u5931\u8d25\u5e38\u89c1\u539f\u56e0\uff1a\u5ef6\u65f6\u540e\u65e0\u53ef\u7528\u00a0Activity\u00a0\/\u00a0\u6355\u83b7\u00a0View\u00a0\u2192\u00a0`ACTIVITY_INVALID`\uff1b\u5f31\u5f15\u7528\u00a0Activity\u00a0\u88ab\u56de\u6536\u7b49\u3002\n\n\u793a\u4f8b\uff1a\n\n```java\nMaterialMonitor.get().collectFrameFromAdPage(\n InterstitialAdActivity.this, adInfo, timing,\n new FrameOptions.Builder().delayMs(3000).build(), callback);\n```\n\n### 5.5\u00a0`onAdClosed`\n\n\u7b7e\u540d\n\n```text\nvoid onAdClosed(ATAdInfo adInfo)\n```\n\n| \u53c2\u6570 | \u8bf4\u660e |\n| --- | --- |\n| `adInfo` | \u5f53\u524d\u5173\u95ed\u7684\u5e7f\u544a\uff1b\u6309\u00a0`ATAdInfo.getShowId()`\u00a0\u5339\u914d\u4ecd\u5728\u00a0`delayMs`\u00a0\u7b49\u5f85\u4e2d\u7684\u91c7\u96c6\u4efb\u52a1\u3002 |\n\n\u884c\u4e3a\uff1a\u82e5\u540c\u4e00\u00a0`showId`\u00a0\u7684\u00a0`collectFrameFromAdContainer`\u00a0\u6216\u00a0`collectFrameFromAdPage`\u00a0\u5c1a\u672a\u6267\u884c\u622a\u5c4f\uff0c\u5219\u00a0\u53d6\u6d88\u00a0\u672c\u6b21\u91c7\u96c6\u5e76\u56de\u8c03\u00a0`onCollectFailure(COLLECT_CANCELLED,\u00a0\u2026)`\uff0c\u907f\u514d\u5e7f\u544a\u5df2\u5173\u4ecd\u622a\u5230\u7a7a\u767d\u6216\u5bbf\u4e3b\u9875\u3002\n\n\u4f55\u65f6\u8c03\u7528\uff1a\u5728\u5e7f\u544a\u00a0\u5173\u95ed\u56de\u8c03\u00a0\u4e2d\u8c03\u7528\uff08Demo\uff1a`onInterstitialAdClose`\u3001`onRewardedVideoAdClosed`\uff09\u3002Dialog\u00a0\/\u00a0overlay\u00a0\/\u00a0\u5bbf\u4e3b\u00a0Activity\u00a0\u4e0a\u5c55\u793a\u7684\u63d2\u5c4f\u00a0\u5efa\u8bae\u5fc5\u8c03\uff1b\u72ec\u7acb\u5168\u5c4f\u00a0`AdActivity`\u00a0\u4e14\u751f\u547d\u5468\u671f\u5df2\u8db3\u591f\u65f6\u53ef\u7701\u7565\u3002\n\n```java\n@Override\npublic void onInterstitialAdClose(ATAdInfo adInfo) {\n MaterialMonitor.get().onAdClosed(adInfo);\n}\n```\n\n### 5.6\u00a0`reportFrameRecord`\n\n\u7b7e\u540d\n\n```text\nvoid reportFrameRecord(FrameRecord record, ATAdInfo adInfo)\nvoid reportFrameRecord(FrameRecord record, ATAdInfo adInfo, ReportCallback callback)\n```\n\n| \u53c2\u6570 | \u8bf4\u660e |\n| --- | --- |\n| `record` | \u622a\u5c4f\u8def\u5f84\u987b\u542b\u00a0\u5df2\u5b58\u5728\u00a0\u7684\u672c\u5730\u00a0JPEG\u00a0`file`\uff1burl-only\u00a0\u91c7\u96c6\u65f6\u00a0`file`\u00a0\u4e3a\u00a0null\uff0c\u7531\u00a0`collectFrameFromNativeAdContainer`\u00a0\u81ea\u52a8\u5165\u961f\uff0c\u4e00\u822c\u65e0\u9700\u624b\u52a8\u8c03\u7528\u3002`uploadTaskId`\u00a0\u4e3a\u7a7a\u65f6\u5165\u961f\u4f1a\u751f\u6210\u00a0\u65b0\u00a0`task_id`\u3002 |\n| `adInfo` | \u4e0e\u5f53\u65f6\u5c55\u793a\u4e00\u81f4\uff0c\u7528\u4e8e\u7ec4\u88c5\u00a0`meta`\u00a0\u4e2d\u5e7f\u544a\u5b57\u6bb5\u3002 |\n| `callback` | \u4ec5\u4e0a\u62a5\u7ed3\u679c\uff1a`onReportSuccess`\u00a0\/\u00a0`onReportSkip`\u00a0\/\u00a0`onReportFailure`\uff08\u65e0\u00a0`onCollect`\uff09\u3002 |\n\n\u5178\u578b\u7528\u9014\uff1a\u5148\u91c7\u96c6\u843d\u76d8\u3001\u540e\u62e9\u673a\u4e0a\u4f20\uff1b\u6216\u91c7\u96c6\u6210\u529f\u4f46\u6b64\u524d\u4e0a\u4f20\u5931\u8d25\u540e\u7684\u8865\u4f20\uff08\u6ce8\u610f\u00a0`uploadTaskId`\u00a0\u4e0e\u91cd\u590d\u5165\u961f\u8bed\u4e49\uff09\u3002\n\n### 5.7\u00a0`flushPendingFrames`\n\n```text\nvoid flushPendingFrames()\n```\n\n\u4f5c\u7528\uff1a\u4e3b\u52a8\u8bf7\u6c42\u6a21\u5757\u00a0\u5c3d\u5feb\u5904\u7406\u4e00\u6b21\u00a0SQLite\u00a0\u4e2d\u4ecd\u5b58\u5728\u7684\u00a0\u5f85\u4e0a\u4f20\u4efb\u52a1\uff08\u5185\u90e8\u4f1a\u8c03\u5ea6\u4e0a\u4f20\u6267\u884c\u5668\u91cc\u7684\u00a0drain\uff0c\u4e0e\u300c\u65b0\u4efb\u52a1\u5165\u961f\u300d\u89e6\u53d1\u7684\u5904\u7406\u540c\u6e90\uff09\u3002\u53ef\u4ece\u4efb\u610f\u7ebf\u7a0b\u8c03\u7528\uff0c\u5185\u90e8\u4f1a\u5207\u5230\u4e0a\u4f20\u7ebf\u7a0b\u4e0e\u4e3b\u7ebf\u7a0b\u00a0`Handler`\uff0c\u4e0d\u4f1a\u5728\u8c03\u7528\u7ebf\u7a0b\u4e0a\u505a\u00a0HTTP\u3002\n\n\u5178\u578b\u4f7f\u7528\u573a\u666f\uff08\u6309\u9700\u9009\u7528\uff1b\u4e0e\u300c\u65b0\u4efb\u52a1\u5165\u961f\u81ea\u52a8\u00a0drain\u300d\u53e0\u52a0\u4e00\u822c\u65e0\u5bb3\uff09\uff1a\n\n| \u573a\u666f | \u8bf4\u660e |\n| --- | --- |\n| \u7f51\u7edc\u4ece\u4e0d\u53ef\u7528\u5230\u53ef\u7528 | \u65e0\u7f51\u3001`NETWORK_ERROR`\u00a0\u5ef6\u540e\u8def\u5f84\u4e0b\u4efb\u52a1\u4ecd\u5728\u5e93\u4e2d\uff1b\u5728\u00a0`NetworkCallback.onAvailable`\u3001\u6216\u81ea\u5efa\u300c\u5df2\u8054\u7f51\u300d\u5224\u65ad\u91cc\u8c03\u7528\uff0c\u53ef\u7f29\u77ed\u7b49\u5230\u4e0b\u4e00\u6b21\u00a0\u7ea6\u00a030s\u00a0\u5b9a\u65f6\u63a2\u6d4b\u7684\u95f4\u9694\u3002 |\n| \u7528\u6237\u6253\u5f00\u00a0Wi\u2011Fi\u00a0\/\u00a0\u8702\u7a9d\u540e\u56de\u5230\u00a0App | \u5728\u00a0`onResume`\u00a0\u6216\u7f51\u7edc\u56de\u8c03\u91cc\u00a0`flushPendingFrames()`\u3002 |\n| \u65e5\u914d\u989d\u00a0\/\u00a0\u9650\u6d41\u89e3\u9664\u540e | \u5c01\u7981\u7a97\u53e3\u8fc7\u540e\u53ef\u914d\u5408\u4e1a\u52a1\u5224\u65ad\u518d\u00a0`flush`\u3002 |\n\n\u4e00\u822c\u4e0d\u5fc5\uff1a\u4ec5\u4f9d\u8d56\u8fdb\u7a0b\u5185\u00a0\u5165\u961f\u00a0\/\u00a0init\u00a0\u65f6\u7684\u81ea\u52a8\u00a0drain\u00a0\u4e5f\u80fd\u5728\u6062\u590d\u7f51\u7edc\u540e\u9646\u7eed\u4e0a\u4f20\uff1b\u65e0\u5168\u5c40\u7f51\u7edc\u76d1\u542c\u65f6\uff0c\u81f3\u5c11\u5728\u00a0\u7f51\u7edc\u53ef\u7528\u56de\u8c03\u00a0+\u00a0\u4e3b\u00a0Activity\u00a0`onResume`\u00a0\u8c03\u7528\u5373\u53ef\u3002\n\n\u4e0e\u300c\u65e0\u7f51\u5ef6\u540e\u300d\u7684\u5173\u7cfb\uff1a`flush`\u00a0\u53ea\u5524\u9192\u4e0a\u4f20\u961f\u5217\uff0c\u4e0d\u91cd\u65b0\u622a\u5c4f\uff1b\u65e0\u7f51\u65f6\u00a0drain\u00a0\u5185\u4ecd\u4f1a\u9884\u68c0\u5931\u8d25\u5e76\u518d\u6b21\u6392\u7a0b\uff0c\u4f46\u6bd4\u5e72\u7b49\u5b9a\u65f6\u5668\u66f4\u53ca\u65f6\u3002\n\n\u6ce8\u610f\uff1a`flush`\u00a0\u4e0d\u7ed5\u8fc7\u65e5\u914d\u989d\u95e8\uff1b\u672c\u5730\u6587\u4ef6\u5df2\u5220\u6216\u4efb\u52a1\u5df2\u7ec8\u6001\u5219\u65e0\u4e0a\u4f20\u53ef\u505a\u3002\u65e0\u7f51\u5ef6\u540e\u3001\u56de\u8c03\u8bed\u4e49\u7b49\u89c1\u00a0\u00a79\u3002\n\n### 5.8\u00a0`getRecords`\u00a0\/\u00a0`deleteRecord`\n\n```text\nList getRecords(MaterialStyle style)\nboolean deleteRecord(FrameRecord record)\n```\n\n| \u65b9\u6cd5 | \u8bf4\u660e |\n| --- | --- |\n| `getRecords` | \u679a\u4e3e\u67d0\u00a0`MaterialStyle`\u00a0\u5bf9\u5e94\u76ee\u5f55\u4e0b\u5386\u53f2\u00a0JPEG\u00a0\u6587\u4ef6\uff1b\u8fd4\u56de\u7684\u00a0`FrameRecord`\u00a0\u90e8\u5206\u5b57\u6bb5\u53ef\u80fd\u4e3a\u5360\u4f4d\uff08\u4ec5\u4fdd\u8bc1\u00a0`style`\u4e0e\u00a0`file`\u00a0\u7b49\u6587\u4ef6\u7ea7\u4fe1\u606f\uff09\uff0c\u4e0d\u5b9c\u5f53\u4f5c\u5b8c\u6574\u4e0a\u62a5\u5143\u6570\u636e\u552f\u4e00\u6765\u6e90\u3002 |\n| `deleteRecord` | \u5148\u53d6\u6d88\u4e0e\u8be5\u00a0`FrameRecord`\u00a0\u7684\u00a0`uploadTaskId`\u00a0\u6216\u672c\u5730\u8def\u5f84\u5339\u914d\u7684\u00a0\u5f85\u4e0a\u4f20\u4efb\u52a1\uff0c\u518d\u5220\u6587\u4ef6\uff0c\u907f\u514d\u961f\u5217\u4e0e\u78c1\u76d8\u4e0d\u4e00\u81f4\u3002 |\n\n`MaterialStyle`\u00a0\u679a\u4e3e\uff1a`SPLASH`\u3001`BANNER`\u3001`INTERSTITIAL`\u3001`REWARDED_VIDEO`\u3001`NATIVE`\uff08\u4e0e\u6587\u4ef6\u5939\u540d\u4e00\u81f4\uff0c\u89c1\u6e90\u7801\u00a0`getFolderName()`\uff09\u3002\n\n---\n\n## 6.\u00a0`FrameOptions`\u00a0\u4e0e\u00a0`AdTimingInput`\n\n### 6.1\u00a0`FrameOptions.Builder`\n\n| \u65b9\u6cd5\u00a0\/\u00a0\u5b57\u6bb5 | \u9ed8\u8ba4 | \u8bf4\u660e |\n| --- | --- | --- |\n| `delayMs(long)` | `500` | \u2265\u00a00\u3002\u5efa\u8bae\u6309\u00a0\u00a74.2\u00a0\u8c03\u6574\uff1a\u6fc0\u52b1\u00a02\uff5e5s\uff0c\u5176\u4ed6\u00a0\u7ea6\u00a02s\uff1b\u5173\u95ed\u524d\u5b9a\u70b9\u53ef\u7528\u00a0`0`\u3002 |\n| `maxSizeKb(int)` | `300` | \u8f93\u51fa\u00a0JPEG\u00a0\u4e0a\u9650\uff0c\u4e0e\u7f51\u5173\u300c\u5355\u56fe\u00a0\u2264300KB\u300d\u5bf9\u9f50\uff1b\u5141\u8bb8\u8303\u56f4\u00a080,\u00a0300\uff08\u8d85\u51fa\u4f1a\u88ab\u00a0clamp\uff09\u3002 |\n| `maxLongEdge(int)` | `1080` | \u6700\u957f\u8fb9\u50cf\u7d20\u4e0a\u9650\uff1b\u5141\u8bb8\u00a0540,\u00a01440\uff08\u8d85\u51fa\u4f1a\u88ab\u00a0clamp\uff09\u3002\u9ed8\u8ba4\u00a01080\u00a0\u5728\u00a0300KB\u00a0\u7f51\u5173\u9650\u5236\u4e0e\u5ba1\u6838\u53ef\u8bfb\u6027\u4e4b\u95f4\u6298\u4e2d\uff1b\u8bc6\u522b\u8981\u6c42\u66f4\u9ad8\u53ef\u8c03\u81f3\u00a01440\u00a0\u5e76\u9a8c\u8bc1\u00a0JPEG\u00a0\u4f53\u79ef\u3002\u82e5\u622a\u5e27\u9891\u7387\u9ad8\u5219\u503e\u5411720\u00a0\u6216\u00a0\u66f4\u4f4e |\n| `keepQualityFirst(boolean)` | `true` | \u4f18\u5148\u8f83\u9ad8\u00a0JPEG\u00a0\u8d28\u91cf\u518d\u964d\u8d28\u91cf\/\u7f29\u5c0f\uff0c\u76f4\u5230\u6ee1\u8db3\u00a0`maxSizeKb`\u3002 |\n\n\u6784\u5efa\uff1a`new\u00a0FrameOptions.Builder().delayMs(2000).maxSizeKb(300).build()`\u3002\n\n### 6.2\u00a0`AdTimingInput`\n\n| \u6784\u9020\u00a0\/\u00a0\u5de5\u5382 | \u8bf4\u660e |\n| --- | --- |\n| `new\u00a0AdTimingInput(requestTimeMs,\u00a0fillTimeMs,\u00a0showTimeMs)` | \u6beb\u79d2\uff1b\u5199\u5165\u00a0`meta.event_info`\u00a0\u65f6\u8f6c\u4e3a\u79d2\u3002 |\n\n\u7f51\u5173\u5bf9\u00a0`request_ts`\u00a0\/\u00a0`fill_ts`\u00a0\/\u00a0`show_ts`\u00a0\u7684\u5fc5\u586b\u8bed\u4e49\u4ee5\u5bf9\u63a5\u6587\u6863\u4e3a\u51c6\uff1b\u5e93\u5185\u5bf9\u00a0\u22640\u00a0\u7684\u9879\u4f1a\u6309\u00a0`show_ts`\u00a0\u7b49\u540c\u79d2\u505a\u56de\u586b\uff08\u89c1\u00a0`CreativeMetaBuilder`\uff09\uff0c\u751f\u4ea7\u73af\u5883\u4ecd\u5efa\u8bae\u4f20\u5165\u771f\u5b9e\u4e09\u9636\u6bb5\u65f6\u95f4\u3002\n\n---\n\n## 7.\u00a0\u56de\u8c03\u8bf4\u660e\uff08`FrameCallback`\u00a0\/\u00a0`AbstractFrameCallback`\uff09\n\n```java\nAbstractFrameCallback() {\n @Override\n public void onCollectSuccess(FrameRecord record) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u622a\u5c4f\u6210\u529f\u65f6 file \u5df2\u5199\u597d\uff1burl-only \u65f6 file \u4e3a null\u3001\u4ec5\u5e26 image_url\n }\n\n @Override\n public void onCollectFailure(int errorCode, String message, Throwable cause) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u672a\u5165\u961f\u4e0a\u4f20\n }\n\n @Override\n public void onReportSuccess(FrameRecord record) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u4e0a\u4f20\u6210\u529f\uff1brecord.getFile() \u901a\u5e38\u4e3a null\uff08\u5e93\u5df2\u5220 JPEG\uff09\n }\n\n @Override\n public void onReportSkip(FrameRecord record, String reason) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u91cd\u590d task\u3001\u914d\u989d\u5c01\u7981\u7b49\n }\n\n @Override\n public void onReportFailure(int errorCode, String message, FrameRecord record, Throwable cause) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1arecord \u53ef\u80fd\u4e3a null\uff08\u7ec8\u7aef\u5931\u8d25\u4e14\u5df2\u6e05\u7406\uff09\n }\n }\n```\n```java\nMaterialMonitor.get().collectFrameFromAdContainer(target, adInfo, AdTimingTracker.mock(), options,\n MaterialMonitorHelper.demoFrameCallback(this));\n```\n\n\u82e5`frameCallback`\u9700\u8981\u6301\u6709activity\uff0c\u4e3a\u907f\u514d\u5185\u5b58\u6cc4\u6f0f\u63a8\u8350\u4e24\u79cd\u4f7f\u7528\u8def\u5f84\uff1a\u00a0\n\n1. static\u00a0\u5185\u90e8\u7c7b\u00a0+\u00a0\u5f15\u7528\u00a0`Activity.this`\u65b9\u5f0f\uff1a\u53c2\u8003`MaterialMonitorHelper.demoFrameCallback(activity)`\u00a0\u5f31\u5f15\u7528\u6301\u6709activity\uff1b\n \n2. \u533f\u540d\u00a0\/\u00a0\u975e\u00a0static\u00a0\u5185\u90e8\u7c7b\u00a0+\u00a0\u5f3a\u5f15\u7528\u00a0`Activity.this`\u65b9\u5f0f\uff1a\u53ef\u5728activity\u00a0`onDestroy`\u00a0\u5bf9\u63a5\u00a0\u4f20\u5165\u4e0e\u00a0`collect`\u00a0\u7684\u540c\u4e00\u5b9e\u4f8b\u00a0`frameCallback`\uff1a\n \n\n```java\n MaterialMonitor.get().detachCallback(frameCallback);\n```\n---\n\n## 8.\u00a0\u9519\u8bef\u7801\u901f\u67e5\uff08`com.github.material.monitor.ErrorCodes`\uff09\n\nSDK\u00a0\u56de\u8c03\u91cc\u7684\u00a0`errorCode`\u00a0\u5747\u4e3a\u00a06xxx\u00a0\u7aef\u4fa7\u7801\uff0c\u4e0e\u7f51\u5173\u00a0HTTP\u00a0\u54cd\u5e94\u00a0JSON\u00a0\u7684\u00a0`code`\uff081xxx\uff5e5xxx\uff09\u4e0d\u662f\u540c\u4e00\u5957\u6570\u503c\u3002\u6392\u67e5\u7f51\u5173\u95ee\u9898\u65f6\uff0c\u8bf7\u770b\u5931\u8d25\u00a0`message`\u00a0\u91cc\u7684\u00a0`gateway\u00a0NNNN:\u00a0\u2026`\u00a0\u524d\u7f00\uff0c\u5e76\u5bf9\u7167\u00a0`CreativeAuditGateway\u00a0-\u00a0SDK\u5bf9\u63a5\u6587\u6863`\u3002\n\n### 8.1\u00a0\u7aef\u4fa7\u9519\u8bef\u7801\u4e00\u89c8\n\n| \u7801 | \u5e38\u91cf | \u56de\u8c03 | \u7ec8\u7aef | \u542b\u4e49\u4e0e\u5904\u7406\u5efa\u8bae |\n| --- | --- | --- | --- | --- |\n| 6001 | `VIEW_INVALID` | `onCollectFailure` | \u662f | \u5bb9\u5668\u4e3a\u7a7a\u3001\u672a\u00a0attach\uff0c\u6216\u00a0`delayMs`\u00a0\u540e\u00a0View\u00a0\u5df2\u9500\u6bc1\u00a0\u2192\u00a0\u5728\u00a0\u5c55\u793a\u4e14\u4ecd\u00a0attached\u00a0\u7684\u56de\u8c03\u91cc\u8c03\u7528\uff1b\u9002\u5f53\u589e\u5927\u00a0`delayMs` |\n| 6002 | `ACTIVITY_INVALID` | `onCollectFailure` | \u662f | \u5168\u5c4f\u91c7\u96c6\u5ef6\u65f6\u540e\u65e0\u53ef\u7528\u9875\u9762\u00a0\u2192\u00a0`collectFrameFromAdPage`\u00a0\u4f20\u5165\u6709\u6548\u00a0`hostActivity`\uff1b\u786e\u8ba4\u5e7f\u544a\u9875\u4ecd\u5728\u524d\u53f0 |\n| 6003 | `COLLECTION_FAILED` | `onCollectFailure` | \u662f | \u622a\u5c4f\u5931\u8d25\uff08\u542b\u00a0`PixelCopy`\u00a0\u5931\u8d25\uff09\u2192\u00a0\u89c6\u9891\u7c7b\u7528\u5bb9\u5668\u00a0API\uff1b\u4f4e\u7248\u672c\u53ef\u80fd\u53ea\u80fd\u00a0`View.draw`\uff0c\u53ef\u589e\u5927\u00a0`delayMs` |\n| 6004 | `COMPRESS_FAILED` | `onCollectFailure` | \u662f | JPEG\u00a0\u8d85\u00a0`maxSizeKb`\u00a0\u9884\u7b97\u00a0\u2192\u00a0\u964d\u4f4e\u00a0`maxLongEdge`\u00a0\u6216\u00a0`maxSizeKb`\uff0c\u6216\u7f29\u5c0f\u622a\u5e27\u533a\u57df |\n| 6005 | `PARAM_INVALID` | `onCollectFailure`\u00a0\/\u00a0`onReportFailure` | \u662f | \u5165\u53c2\u4e0d\u5408\u6cd5\uff08`adInfo`\/`timing`\/`hostActivity`\u00a0\u7b49\uff09\u6216\u00a0`reportFrameRecord`\u00a0\u65f6\u672c\u5730\u6587\u4ef6\u4e0d\u5b58\u5728 |\n| 6006 | `NETWORK_ERROR` | `onReportFailure` | \u5426 | \u65e0\u7f51\u6216\u4f20\u8f93\u5931\u8d25\uff1b\u4efb\u52a1\u4ecd\u6392\u961f\uff0c\u4e0d\u5360\u91cd\u8bd5\u4e0a\u9650\u00a0\u2192\u00a0\u6062\u590d\u7f51\u7edc\u540e\u00a0`flushPendingFrames()`\uff08\u00a79.2\uff09\uff1b\u6210\u529f\u540e\u4ecd\u53ef\u80fd\u00a0`onReportSuccess` |\n| 6007 | `RETRY_EXHAUSTED` | `onReportFailure` | \u662f | \u4e0a\u4f20\u91cd\u8bd5\u8017\u5c3d\u00a0\u2192\u00a0\u67e5\u00a0`message`\u00a0\u4e2d\u7f51\u5173\u7801\uff1b\u9700\u8865\u4f20\u65f6\u7528\u65b0\u00a0`uploadTaskId`\u00a0\u91cd\u65b0\u00a0`reportFrameRecord`\u00a0\u6216\u91cd\u65b0\u91c7\u96c6 |\n| 6008 | `NOT_READY` | `onCollectFailure`\u00a0\/\u00a0`onReportFailure` | \u662f | \u672a\u00a0`init`\u3001\u5df2\u00a0`shutdown`\uff0c\u6216\u00a0`baseUploadUrl`\/`appId`\/`appKey`\u00a0\u672a\u914d\u9f50 |\n| 6009 | `COLLECT_CANCELLED` | `onCollectFailure` | \u662f | \u5ef6\u65f6\u672a\u622a\u5c4f\u524d\u5e7f\u544a\u5df2\u5173\uff08`onAdClosed`\uff09\u2192\u00a0\u9884\u671f\u884c\u4e3a\uff1b\u5173\u95ed\u56de\u8c03\u4e2d\u8c03\u7528\u00a0`onAdClosed`\u00a0\u53ef\u907f\u514d\u8bef\u91c7 |\n\n### 8.2\u00a0\u56de\u8c03\u4e0e\u9519\u8bef\u7801\n\n| \u56de\u8c03 | \u8bf4\u660e |\n| --- | --- |\n| `onCollectFailure` | \u91c7\u96c6\/\u5199\u76d8\u5931\u8d25\uff0c\u6216\u00a0`onAdClosed`\u00a0\u53d6\u6d88\uff1b\u4e0d\u4f1a\u81ea\u52a8\u5165\u961f\u4e0a\u4f20 |\n| `onReportFailure` | \u4e0a\u62a5\u94fe\u5931\u8d25\uff1b6006\u00a0\u4e3a\u975e\u7ec8\u7aef\uff0c\u5176\u4f59\u591a\u4e3a\u7ec8\u7aef\uff08\u672c\u5730\u4efb\u52a1\u53ef\u80fd\u5df2\u6e05\u7406\uff09 |\n| `onReportSkip` | \u4e0d\u662f\u9519\u8bef\u7801\uff1b\u5982\u65e5\u914d\u989d\u5c01\u7981\u3001\u91cd\u590d\u00a0`uploadTaskId`\uff0c\u770b\u00a0`reason`\u00a0\u5b57\u7b26\u4e32 |\n\n\u91c7\u96c6\u00a0vs\u00a0\u4e0a\u62a5\uff1a6001\uff5e6004\u30016009\u00a0\u53ea\u51fa\u73b0\u5728\u00a0`onCollectFailure`\uff1b6005\uff5e6008\u00a0\u4e3b\u8981\u51fa\u73b0\u5728\u00a0`onReportFailure`\uff086005\u00a0\u4e5f\u53ef\u80fd\u5728\u91c7\u96c6\u5165\u53e3\u89e6\u53d1\uff09\u3002\n\n### 8.3\u00a0\u7f51\u5173\u00a0`code`\u00a0\u4e0e\u7aef\u4fa7\u00a0`errorCode`\n\n| \u4f60\u770b\u5230\u7684 | \u8bf4\u660e |\n| --- | --- |\n| \u56de\u8c03\u00a0`errorCode`\uff086xxx\uff09 | SDK\u00a0\u91c7\u96c6\u94fe\u53ca\u65e0\u00a0HTTP\u00a0\u54cd\u5e94\u65f6\u7684\u4e0a\u62a5\u9519\u8bef\uff08\u5982\u00a06006\u00a0\u65e0\u7f51\uff09 |\n| \u56de\u8c03\u00a0`errorCode`\uff081xxx\uff5e5xxx\uff09 | \u90e8\u5206\u00a0\u7f51\u5173\u7ec8\u6001\u5931\u8d25\u00a0\u65f6\uff0c`errorCode`\u00a0\u53ef\u80fd\u4e0e\u54cd\u5e94\u00a0body\u00a0\u7684\u00a0`code`\u00a0\u76f8\u540c\uff1b\u4ecd\u5efa\u8bae\u4ee5\u00a0`message`\u00a0\u4e3a\u51c6 |\n| `message`\u00a0\u4e2d\u00a0`gateway\u00a0NNNN:` | \u7f51\u5173\u539f\u59cb\u534f\u8bae\u7801\u4e0e\u6587\u6848\uff0c\u8054\u8c03\u65f6\u00a0\u4f18\u5148\u89e3\u6790\u6b64\u5b57\u6bb5 |\n| \u54cd\u5e94\u00a0body\u00a0`trace_id` | \u6210\u529f\/\u5931\u8d25\u5747\u53ef\u80fd\u8fd4\u56de\uff0c\u8054\u7cfb\u00a0TopOn\u00a0\u6280\u672f\u652f\u6301\u65f6\u4e00\u5e76\u63d0\u4f9b |\n\n\u4e0d\u8981\u628a\u00a06xxx\u00a0\u7aef\u4fa7\u7801\u4e0e\u7f51\u5173\u00a01xxx\uff5e5xxx\u00a0\u6df7\u5728\u540c\u4e00\u5957\u57cb\u70b9\u679a\u4e3e\u91cc\u3002\u7f51\u5173\u7801\u5b8c\u6574\u8868\u89c1\u00a0\u00a78.4\u3002\n\n### 8.4\u00a0\u7f51\u5173\u54cd\u5e94\u9519\u8bef\u7801\uff08CreativeAuditGateway\uff09\n\n\u4e0a\u4f20\u63a5\u53e3\u00a0`POST\u00a0\u2026\/v1\/creative\/upload`\u00a0\u8fd4\u56de\u00a0JSON\uff0c`code\u00a0==\u00a00`\u00a0\u8868\u793a\u6210\u529f\uff08HTTP\u00a0\u901a\u5e38\u4e3a\u00a0200\uff09\u3002\u5931\u8d25\u65f6\u00a0`code`\u00a0\u4e3a\u975e\u00a00\uff0c\u4e14\u00a0`trace_id`\u00a0\u5728\u6210\u529f\u4e0e\u5931\u8d25\u65f6\u5747\u53ef\u80fd\u8fd4\u56de\uff0c\u8bf7\u5931\u8d25\u65f6\u843d\u65e5\u5fd7\u4fbf\u4e8e\u6392\u67e5\u3002\n\n> \u4ee5\u4e0b\u4e0e\u00a0`document\/CreativeAuditGateway\u00a0-\u00a0SDK\u5bf9\u63a5\u6587\u6863.md`\u00a0\u00a7\u516b\u00a0\u4e00\u81f4\uff1b\u82e5\u7f51\u5173\u7248\u672c\u6709\u589e\u5220\uff0c\u4ee5\u5728\u7ebf\u63a5\u53e3\u8bf4\u660e\u4e3a\u51c6\u3002\n\n#### 8.4.1\u00a0\u6210\u529f\n\n| code | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e |\n| --- | --- | --- |\n| 0 | ok | \u4e0a\u4f20\u6210\u529f\uff1b\u540c\u4e00\u00a0`event_info.show_id`\u00a0\u91cd\u590d\u4e0a\u62a5\u4e5f\u8fd4\u56de\u00a00\uff08\u5e42\u7b49\uff0c\u4e0d\u91cd\u590d\u6263\u914d\u989d\uff09 |\n\n#### 8.4.2\u00a01xxx\u00a0\u2014\u00a0\u9274\u6743\u9519\u8bef\uff08\u4e0d\u53ef\u91cd\u8bd5\uff09\n\n| code | HTTP | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e | \u5efa\u8bae\u5904\u7406 |\n| --- | --- | --- | --- | --- |\n| 1001 | 401 | unauthorized | \u7b7e\u540d\u6821\u9a8c\u5931\u8d25\u6216\u00a0`app_id`\u00a0\u65e0\u6548 | \u68c0\u67e5\u00a0`appKey`\u3001\u7b7e\u540d\u7b97\u6cd5\u3001`appId` |\n| 1002 | 403 | forbidden | \u672a\u5f00\u901a\u7d20\u6750\u76d1\u6d4b\u80fd\u529b | \u8054\u7cfb\u00a0TopOn\u00a0\u8fd0\u8425\u5f00\u901a |\n\n#### 8.4.3\u00a02xxx\u00a0\u2014\u00a0\u53c2\u6570\u00a0\/\u00a0\u56fe\u7247\u9519\u8bef\uff08\u4e0d\u53ef\u91cd\u8bd5\uff09\n\n| code | HTTP | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e | \u5efa\u8bae\u5904\u7406 |\n| --- | --- | --- | --- | --- |\n| 2001 | 400 | invalid\u00a0params | `meta`\u00a0\u5fc5\u586b\u5b57\u6bb5\u7f3a\u5931\u6216\u683c\u5f0f\u9519\u8bef | \u6838\u5bf9\u00a0`ATAdInfo`\u3001`AdTimingInput`\u3001\u8bbe\u5907\u5b57\u6bb5 |\n| 2002 | 400 | image\u00a0too\u00a0large | JPEG\u00a0\u8d85\u8fc7\u00a0300KB | \u964d\u4f4e\u00a0`maxSizeKb`\u00a0\/\u00a0`maxLongEdge` |\n| 2003 | 400 | invalid\u00a0image\u00a0format | \u975e\u00a0JPEG | \u786e\u8ba4\u622a\u5c4f\u8f93\u51fa\u4e3a\u00a0JPEG |\n| 2005 | 400 | request\u00a0body\u00a0too\u00a0large | \u6574\u5305\u8d85\u8fc7\u00a0512KB | \u7f29\u5c0f\u56fe\u7247\u6216\u8d70\u00a0url-only |\n\n#### 8.4.4\u00a03xxx\u00a0\u2014\u00a0\u914d\u989d\u9519\u8bef\uff08\u5f53\u65e5\u4e0d\u518d\u4e0a\u62a5\uff09\n\n| code | HTTP | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e | \u5efa\u8bae\u5904\u7406 |\n| --- | --- | --- | --- | --- |\n| 3001 | 429 | account\u00a0quota\u00a0exceeded | \u5e10\u6237\u6bcf\u65e5\u914d\u989d\u7528\u5b8c | \u5f53\u5929\u505c\u6b62\u4e0a\u62a5\uff1b\u54cd\u5e94\u6216\u00a0`onReportSkip`\/`reason`\u00a0\u4e2d\u53ef\u80fd\u6709\u00a0`daily_quota_reset_at` |\n| 3002 | 429 | app\u00a0quota\u00a0exceeded | App\u00a0\u6bcf\u65e5\u914d\u989d\u7528\u5b8c | \u540c\u4e0a\uff0c\u9488\u5bf9\u5355\u4e2a\u00a0App |\n\n#### 8.4.5\u00a04xxx\u00a0\u2014\u00a0\u9650\u6d41\uff08\u53ef\u91cd\u8bd5\uff09\n\n| code | HTTP | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e | \u5efa\u8bae\u5904\u7406 |\n| --- | --- | --- | --- | --- |\n| 4001 | 429 | rate\u00a0limit\u00a0exceeded | \u8bf7\u6c42\u9891\u7387\u8fc7\u9ad8 | \u7b49\u5f85\u54cd\u5e94\u00a0Header\u00a0`Retry-After`\uff08\u901a\u5e38\u00a0\u22651s\uff09\u540e\u91cd\u8bd5 |\n\n#### 8.4.6\u00a05xxx\u00a0\u2014\u00a0\u670d\u52a1\u7aef\u9519\u8bef\uff08\u53ef\u91cd\u8bd5\uff09\n\n| code | HTTP | msg\uff08\u793a\u4f8b\uff09 | \u8bf4\u660e | \u5efa\u8bae\u5904\u7406 |\n| --- | --- | --- | --- | --- |\n| 5001 | 500 | upload\u00a0failed | \u670d\u52a1\u7aef\u5b58\u50a8\u5f02\u5e38 | SDK\u00a0\u81ea\u52a8\u91cd\u8bd5\uff1b\u4ecd\u5931\u8d25\u5219\u00a0`RETRY_EXHAUSTED`\uff086007\uff09 |\n| 5002 | 500 | internal\u00a0error | \u670d\u52a1\u7aef\u5185\u90e8\u9519\u8bef | \u540c\u4e0a |\n| 5003 | 502 | image\u00a0download\u00a0failed | `meta.image_url`\u00a0\u4e0b\u8f7d\u5931\u8d25 | \u68c0\u67e5\u00a0URL\u00a0\u53ef\u8bbf\u95ee\u6027\uff08\u539f\u751f\u00a0url-only\uff09 |\n| 5004 | 503 | service\u00a0unavailable | \u670d\u52a1\u6682\u4e0d\u53ef\u7528 | \u7a0d\u540e\u91cd\u8bd5 |\n\n#### 8.4.7\u00a0material-monitor\u00a0\u5bf9\u7f51\u5173\u7801\u7684\u5904\u7406\n\n| \u7f51\u5173\u00a0`code` | SDK\u00a0\u884c\u4e3a | \u5bbf\u4e3b\u56de\u8c03 |\n| --- | --- | --- |\n| 0 | \u5220\u672c\u5730\u00a0JPEG\u00a0\u4e0e\u961f\u5217\u884c | `onReportSuccess` |\n| 1001\uff5e1002\u30012001\uff5e2005 | \u7ec8\u7aef\u5931\u8d25\uff0c\u6e05\u7406\u672c\u5730\u4efb\u52a1 | `onReportFailure`\uff1b`message`\u00a0\u542b\u00a0`gateway\u00a0NNNN:\u00a0\u2026` |\n| 3001\uff5e3002 | \u5199\u5165\u65e5\u914d\u989d\u5c01\u7981\u7a97\u53e3\uff0c\u6e05\u7406\u5f53\u524d\u4efb\u52a1 | `onReportFailure`\u00a0\u6216\u540e\u7eed\u65b0\u4efb\u52a1\u00a0`onReportSkip`\uff08`reason`\u00a0\u542b\u00a0`daily_quota_reset_at`\uff09 |\n| 4001\u30015001\uff5e5004 | \u6309\u00a0`maxUploadAttempts`\u00a0\u81ea\u52a8\u91cd\u8bd5\uff084001\u00a0\u81f3\u5c11\u7b49\u5f85\u00a01s\uff09 | \u91cd\u8bd5\u671f\u95f4\u901a\u5e38\u00a0\u65e0\u00a0\u5931\u8d25\u56de\u8c03\uff1b\u8017\u5c3d\u540e\u00a0`onReportFailure(6007,\u00a0\u2026)` |\n| \u65e0\u00a0HTTP\u00a0\u54cd\u5e94\u00a0\/\u00a0\u65e0\u7f51 | \u5ef6\u540e\u7ea6\u00a030s\u00a0\u518d\u8bd5\uff0c\u4e0d\u5360\u91cd\u8bd5\u6b21\u6570 | `onReportFailure(6006,\u00a0\u2026)`\u00a0\u81f3\u591a\u4e00\u6b21\uff1b\u6062\u590d\u7f51\u540e\u53ef\u00a0`onReportSuccess` |\n\n---\n\n## 9.\u00a0\u7f51\u7edc\u3001\u65e0\u7f51\u5ef6\u540e\u4e0e\u961f\u5217\n\n### 9.1\u00a0\u961f\u5217\u4e0e\u7ebf\u7a0b\n\n* \u91c7\u96c6\u6210\u529f\u4e14\u4e0a\u4f20\u5df2\u914d\u7f6e\u65f6\uff0c\u4efb\u52a1\u5199\u5165\u00a0SQLite\uff0c\u7531\u00a0\u5355\u7ebf\u7a0b\u00a0`uploadExecutor`\u00a0\u987a\u5e8f\u4e0a\u4f20\u3002\u00a0\n \n* \u65e5\u914d\u989d\uff083001\/3002\uff09\uff1a\u53ef\u80fd\u00a0`onReportSkip`\uff0c`reason`\u00a0\u542b\u00a0`daily_quota_reset_at`\uff08\u89c1\u7f51\u5173\u6587\u6863\uff09\u3002\n \n\n### 9.2\u00a0\u65e0\u7f51\u00a0\/\u00a0\u4f20\u8f93\u5c42\u5931\u8d25\uff08`NETWORK_ERROR`\u00a0=\u00a06006\uff09\n\n\u4e0a\u4f20\u7ebf\u7a0b\u5728\u00a0\u771f\u6b63\u53d1\u8d77\u00a0HTTP\u00a0\u4e4b\u524d\u00a0\u4f1a\u8c03\u7528\u00a0`NetworkReachability.hasInternet`\uff08\u9700\u00a0`ACCESS_NETWORK_STATE`\uff0c\u7531\u672c\u6a21\u5757\u00a0manifest\u00a0\u5408\u5e76\u8fdb\u5bbf\u4e3b\uff09\uff1a\n\n* Android\u00a0M\uff08API\u00a023\uff09\u53ca\u4ee5\u4e0a\uff1a\u5f53\u524d\u9ed8\u8ba4\u7f51\u7edc\u987b\u5177\u5907\u00a0`NET_CAPABILITY_INTERNET`\u00a0\u4e14\u00a0`NET_CAPABILITY_VALIDATED`\uff08\u7cfb\u7edf\u5df2\u5224\u5b9a\u53ef\u4e0a\u7f51\uff09\uff0c\u5426\u5219\u89c6\u4e3a\u65e0\u7f51\u3002\u00a0\n \n* \u66f4\u4f4e\u7248\u672c\uff1a`NetworkInfo.isConnected()`\u00a0\u4e3a\u771f\u624d\u7ee7\u7eed\u3002\n \n\n\u82e5\u9884\u68c0\u5224\u5b9a\u65e0\u7f51\uff0c\u6216\u00a0`HttpURLConnection`\u00a0\u5728\u6536\u5230\u00a0HTTP\u00a0\u72b6\u6001\u884c\u4e4b\u524d\u5931\u8d25\uff08\u8d85\u65f6\u3001UnknownHost\u3001\u65e0\u8def\u7531\u7b49\uff0c\u4e0a\u4f20\u7ed3\u679c\u8868\u73b0\u4e3a\u00a0`httpCode==0`\u00a0\u4e14\u00a0`gatewayCode==-1`\uff09\uff0c\u8fdb\u5165\u00a0\u5ef6\u540e\u8def\u5f84\uff1a\n\n| \u9879 | \u884c\u4e3a |\n| --- | --- |\n| \u91cd\u8bd5\u8ba1\u6570 | \u4e0d\u589e\u52a0\u00a0`retry_count`\uff08\u4e0d\u8ba1\u5165\u00a0`MaterialMonitorConfig.getMaxUploadAttempts()`\u00a0\u7684\u300c\u53ef\u91cd\u8bd5\u5931\u8d25\u300d\u9884\u7b97\uff09 |\n| \u6570\u636e | \u4fdd\u7559\u00a0DB\u00a0\u884c\u4e0e\u672c\u5730\u00a0JPEG |\n| \u5b9a\u65f6\u518d\u8bd5 | \u7ea6\u00a030\u00a0\u79d2\u00a0\u540e\u518d\u6b21\u8c03\u5ea6\u00a0`processNextUploadTask`\u00a0\u63a2\u6d4b\u961f\u5217 |\n| `onReportFailure` | \u540c\u4e00\u00a0`uploadTaskId`\u00a0\u5728\u300c\u6301\u7eed\u5904\u4e8e\u5ef6\u540e\u72b6\u6001\u300d\u671f\u95f4\uff0c`NETWORK_ERROR`\u00a0\u53ea\u56de\u8c03\u4e00\u6b21\uff0c\u907f\u514d\u65e5\u5fd7\/\u57cb\u70b9\u5237\u5c4f |\n| `ReportCallback`\u00a0\u751f\u547d\u5468\u671f | \u4e0d\u56e0\u8be5\u6b21\u5931\u8d25\u800c\u79fb\u9664\uff1b\u540e\u7eed\u540c\u4e00\u4efb\u52a1\u4e0a\u4f20\u6210\u529f\u65f6\uff0c\u4ecd\u53ef\u6536\u5230\u00a0`onReportSuccess`\uff08\u4e0e\u300c\u5148\u5931\u8d25\u540e\u6210\u529f\u300d\u4e0d\u77db\u76fe\uff0c\u8be6\u89c1\u00a0`ReportCallback`\u00a0JavaDoc\uff09 |\n\n\u5bbf\u4e3b\u53ef\u5728\u00a0`NetworkCallback.onAvailable`\u3001\u56de\u5230\u524d\u53f0\u7684\u00a0`onResume`\u00a0\u7b49\u5904\u8c03\u7528\u00a0`MaterialMonitor.get().flushPendingFrames()`\uff0c\u7f29\u77ed\u300c\u7b49\u00a030\u00a0\u79d2\u300d\u7684\u7a7a\u7a97\uff08\u4e0e\u5185\u90e8\u5b9a\u65f6\u53e0\u52a0\u65e0\u5bb3\uff09\u3002\n\n### 9.3\u00a0`flushPendingFrames`\uff08\u6458\u8981\uff09\n\n```java\nMaterialMonitor.get().flushPendingFrames();\n```\n\n\u4e3b\u52a8\u5524\u9192\u4e00\u6b21\u961f\u5217\u00a0drain\uff1b\u53ef\u4ece\u4efb\u610f\u7ebf\u7a0b\u8c03\u7528\u3002\u5178\u578b\u573a\u666f\u89c1\u00a0\u00a75.7**\u00a0\u8868\u683c\u3002\n\n---\n\n## 10.\u00a0\u9690\u79c1\u4e0e\u5408\u89c4\u5efa\u8bae\n\n* \u53ea\u622a\u53d6\u00a0\u5e7f\u544a\u76f8\u5173\u533a\u57df\u00a0\u7684\u00a0`View`\uff0c\u907f\u514d\u628a\u4e2a\u4eba\u654f\u611f\u754c\u9762\u622a\u8fdb\u53bb\u3002\u00a0\n \n* \u8bbe\u5907\u6807\u8bc6\uff08OAID\u3001GAID\u00a0\u7b49\uff09\u8bf7\u9075\u5b88\u5f53\u5730\u6cd5\u5f8b\u4e0e\u5e73\u53f0\u653f\u7b56\u3002\u00a0\n \n* `appKey`\u00a0\u4e0d\u5efa\u8bae\u786c\u7f16\u7801\u5728\u516c\u5f00\u7684\u5730\u65b9\u3002\n \n\n---\n\n## 11.\u00a0\u6392\u9519\u6e05\u5355\n\n| \u73b0\u8c61 | \u53ef\u80fd\u9519\u8bef\u7801 | \u68c0\u67e5\u9879 |\n| --- | --- | --- |\n| \u8c03\u7528\u65e0\u6548\u679c\u00a0\/\u00a0warn\u00a0`not\u00a0initialized` | \u2014 | \u662f\u5426\u5df2\u00a0`MaterialMonitor.init`\uff1b\u672a\u00a0init\u00a0\u65f6\u00a0`get()`\u00a0\u4e3a\u00a0idle\u00a0\u5b9e\u4f8b |\n| \u5ef6\u65f6\u540e\u91c7\u96c6\u5931\u8d25 | 6001 | View\u00a0\u662f\u5426\u4ecd\u00a0attached\uff1b\u8c03\u7528\u65f6\u673a\u662f\u5426\u8fc7\u65e9 |\n| \u63d2\u5c4f\/\u6fc0\u52b1\u5168\u5c4f\u5931\u8d25 | 6002 | `collectFrameFromAdPage`\u00a0\u662f\u5426\u4f20\u5165\u00a0`hostActivity`\uff1b\u5ef6\u65f6\u540e\u5e7f\u544a\u9875\u662f\u5426\u4ecd\u53ef\u89c1 |\n| \u9ed1\u5c4f\u00a0\/\u00a0\u89c6\u9891\u753b\u9762\u4e0d\u5bf9 | 6003 | \u89c6\u9891\u7528\u00a0`collectFrameFromAdContainer`\uff1b\u589e\u5927\u00a0`delayMs`\uff08\u00a74.2\uff09 |\n| \u56fe\u7247\u8fc7\u5927\u65e0\u6cd5\u538b\u7f29 | 6004 | \u964d\u4f4e\u00a0`maxLongEdge`\uff08540\uff5e1440\uff09\u6216\u00a0`maxSizeKb` |\n| \u5e7f\u544a\u5173\u540e\u4ecd\u60f3\u91c7\u5e27\u5374\u5931\u8d25 | 6009 | \u5c5e\u9884\u671f\uff1b\u672a\u5173\u524d\u5e94\u5b8c\u6210\u91c7\u96c6\uff0c\u6216\u4e0d\u8981\u8c03\u00a0`onAdClosed` |\n| \u4e00\u76f4\u00a0`NOT_READY` | 6008 | `baseUploadUrl`\u3001`appId`\u3001`appKey`\u00a0\u662f\u5426\u9f50\u5168 |\n| `NETWORK_ERROR`\u00a0\u540e\u4ecd\u00a0pending | 6006 | \u5ef6\u540e\u4e0a\u4f20\uff08\u00a79.2\uff09\uff1b\u6062\u590d\u7f51\u7edc\u540e\u00a0`flushPendingFrames()` |\n| \u591a\u6b21\u5931\u8d25\u7ec8\u6001 | 6007\u00a0\/\u00a0\u7f51\u5173\u7801 | \u67e5\u00a0`message`\u00a0\u4e2d\u00a0`gateway\u00a0NNNN:`\u00a0\u4e0e\u00a0`trace_id`\uff08\u00a78.4\uff09 |\n| \u91cd\u590d\u4e0a\u62a5 | \u2014\uff08`onReportSkip`\uff09 | \u540c\u4e00\u00a0`uploadTaskId`\u00a0\u53ea\u5165\u961f\u4e00\u6b21 |\n| \u60f3\u91cd\u65b0\u4e0a\u4f20\u540c\u4e00\u6587\u4ef6 | \u2014 | \u4f7f\u7528\u00a0`uploadTaskId`\u00a0\u4e3a\u7a7a\u7684\u00a0`FrameRecord`\u00a0\u8c03\u00a0`reportFrameRecord`\uff0c\u6216\u91cd\u65b0\u91c7\u96c6 |\n| \u539f\u751f\u56fe\u7247\u65e0\u672c\u5730\u00a0JPEG | \u2014 | \u6709\u6548\u00a0URL\u00a0\u8d70\u00a0url-only\uff1b\u89c6\u9891\u7c7b\u7528\u00a0`collectFrameFromAdContainer` |\n| \u63d2\u5c4f\u622a\u5230\u5bbf\u4e3b\u9875 | 6002\u00a0\/\u00a06003 | \u4f20\u5165\u00a0`hostActivity`\uff1b\u5173\u95ed\u65f6\u8c03\u00a0`onAdClosed` |\n\n\u5b8c\u6574\u9519\u8bef\u7801\u8868\u89c1\u00a0\u00a78\u3002\n\n---","pure_content":"\u672c\u6587\u6863\u9762\u5411\u63a5\u5165\u5e7f\u544aSDK\u00a0\u7684\u5f00\u53d1\u8005\uff0c\u8bf4\u660e\u5982\u4f55\u5728\u5f00\u5c4f\/\u6a2a\u5e45\/\u539f\u751f\uff08\u6709\u5bb9\u5668\uff09 \u4e0e \u63d2\u5c4f\/\u6fc0\u52b1\u89c6\u9891\uff08\u65e0\u5bb9\u5668\uff09 \u4e24\u79cd\u573a\u666f\u4e0b\uff0c\u5728\u5c55\u793a\u56de\u8c03\u91cc\u5bf9\u5e7f\u544a\u753b\u9762\u505a\u622a\u5e27\uff0c\u7528\u4e8e\u7d20\u6750\u5f52\u6863\u3001\u62bd\u68c0\u6216\u4e0a\u62a5\u3002\u8bf7\u7ed3\u5408\u00a0\u5e7f\u544aSDK\u00a0\u7684\u5c55\u793a\u00a0API\u00a0\u4e0e\u56de\u8c03\uff0c\u4fbf\u4e8e\u76f4\u63a5\u843d\u5730\u5b9e\u73b0\u3002\n\u4e0b\u8f7d\u5730\u5740\uff1ahttp:\/\/info.appsmartsite.com\/Material_monitor\/Android_MaterialMonitor.zip\n\n\n\n\n1.\u00a0\u6a21\u5757\u80fd\u529b\n\n\n\n \u80fd\u529b\n \u8bf4\u660e\n\n\n\n\n \u622a\u5e27\n \u5e7f\u544a\u00a0View\u3001\u5168\u5c4f\/overlay\u00a0\u9875\u9762\uff0c\u6216\u539f\u751f\u56fe\u7247\u00a0url-only\uff08meta.image_url\uff09\u2192\u00a0JPEG\uff08\u2264\u00a0\u53ef\u914d\u7f6e\u00a0KB\uff0curl-only\u00a0\u65e0\u672c\u5730\u6587\u4ef6\uff09\n\n\n \u5143\u6570\u636e\n ATAdInfo\u00a0+\u00a0\u4f60\u4f20\u5165\u7684\u00a0AdTimingInput\u00a0+\u00a0\u8bbe\u5907\u5b57\u6bb5\u00a0\u2192\u00a0meta\n\n\n \u4e0a\u62a5\n POST\u00a0{baseUploadUrl}\/v1\/creative\/upload\uff08app_id\u3001sign\u3001meta\u3001image\uff09\n\n\n \u79bb\u7ebf\u961f\u5217\n SQLite\uff1b\u65e0\u7f51\u6216\u4f20\u8f93\u5c42\u5931\u8d25\u65f6\u5ef6\u540e\u91cd\u8bd5\uff08\u4e0d\u5360\u00a0maxUploadAttempts\u00a0\u8ba1\u6570\uff09\uff1b\u65e5\u914d\u989d\u8282\u6d41\n\n\n \u9519\u8bef\u7801\n \u7aef\u4fa7\u00a06xxx\uff08\u00a78.1\uff09+\u00a0\u7f51\u5173\u00a00\u00a0\/\u00a01xxx\uff5e5xxx\uff08\u00a78.4\uff09\n\n\n\n\n2.\u00a0Gradle\u00a0\u63a5\u5165\n2.1\u00a0\u4f5c\u4e3a\u6e90\u7801\u5b50\u6a21\u5757\uff08\u4e0e\u672c\u00a0Demo\u00a0\u76f8\u540c\uff09\n\u5728\u5bbf\u4e3b\u00a0settings.gradle\u00a0\u4e2d\u00a0include\u00a0':material-monitor'\uff0c\u5728\u00a0app\u00a0\u6a21\u5757\uff1a\ndependencies {\n implementation project(':material-monitor')\n \/\/ \u5e7f\u544a SDK \u4f9d\u8d56\u9700\u4fdd\u7559\uff0c\u4fdd\u8bc1\u8fd0\u884c\u65f6\u5b58\u5728 ATAdInfo\n}\n\n\u5c06\u00a0_core_.aar\uff08\u6216\u4e0e\u4f60\u4eec\u7248\u672c\u4e00\u81f4\u7684\u00a0core\uff09\u653e\u5230\u00a0material-monitor\/libs\/\uff0c\u4e0e\u4ed3\u5e93\u4e2d\u00a0material-monitor\/build.gradle\u00a0\u7684\u00a0compileOnly\u00a0fileTree(dir:\u00a0'libs')\u00a0\u4e00\u81f4\u3002\n2.2\u00a0\u6743\u9650\u4e0e\u8981\u6c42\n\n\nminSdkVersion\uff1a\u672c\u5e93\u00a0build.gradle\u00a0\u4e3a\u00a021\uff1b\u5bbf\u4e3b\u82e5\u66f4\u9ad8\u4ee5\u5bbf\u4e3b\u4e3a\u51c6\u3002\u00a0\n\n\nJava\u00a08+\u3002\u00a0\n\n\n\u7f51\u7edc\u6743\u9650\uff1a\u4e0a\u62a5\u9700\u5bbf\u4e3b\u5177\u5907\u00a0INTERNET\u3002\u6a21\u5757\u5df2\u58f0\u660e\u00a0ACCESS_NETWORK_STATE\uff08\u7528\u4e8e\u4e0a\u4f20\u524d\u00a0\u662f\u5426\u6709\u53ef\u7528\u5916\u7f51\u00a0\u7684\u9884\u68c0\uff1b\u5408\u5e76\u00a0manifest\u00a0\u540e\u7531\u7cfb\u7edf\u6388\u4e88\u300c\u67e5\u770b\u7f51\u7edc\u8fde\u63a5\u300d\u7c7b\u6743\u9650\uff09\u3002\u00a0\n\n\n \n \n\n\n\n\n\nCore\u00a0AAR\uff1a\u5c06\u00a0_core_.aar\uff08\u6216\u4e0e\u4f60\u4eec\u7248\u672c\u4e00\u81f4\u7684\u00a0core\uff09\u653e\u5230\u00a0material-monitor\/libs\/\uff0c\u4e0e\u4ed3\u5e93\u4e2d\u00a0material-monitor\/build.gradle\u00a0\u7684\u00a0compileOnly\u00a0fileTree(dir:\u00a0'libs')\u00a0\u4e00\u81f4\u3002\n\n\n\n3.\u00a0\u521d\u59cb\u5316\n\u5728\u9996\u4e2a\u00a0Activity.onCreate\u00a0\u8c03\u7528\uff08\u5185\u90e8\u4f1a\u6ce8\u518c\u751f\u547d\u5468\u671f\u56de\u8c03\u4ee5\u8ddf\u8e2a\u524d\u53f0\u00a0Activity,\u00a0\u53c2\u8003demo\uff09\uff1a\nimport com.github.material.monitor.MaterialMonitor;\nimport com.github.material.monitor.MaterialMonitorConfig;\n\npublic class FirstActivity extends Activity {\n @Override\n public void onCreate() {\n super.onCreate();\n \/\/ \u5f00\u53d1\u8005\u7528\u6237\u534f\u8bae\u5141\u8bb8\u4e4b\u540e\u81ea\u884c\u83b7\u53d6\u548c\u586b\u5145\u8bbe\u5907\u4fe1\u606f\n MaterialMonitor.init(this, new MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-gateway-host\") \/\/ \u4e0a\u4f20\u5730\u5740\n .appId(\"YOUR_APP_ID\")\n .appKey(\"YOUR_APP_KEY\") \/\/ \u8bf7\u52ff\u6cc4\u6f0f\n .oaid(oaidString)\n .androidId(androidIdString)\n .gaid(gaidString)\n \/\/ .imei(...).mac(...)\n \/\/ .maxUploadAttempts(3)\n \/\/ .retryDelayMs(3000L, 10000L)\n \/\/ .connectTimeoutMs(15000).readTimeoutMs(30000)\n \/\/ .debugPerfLogging(BuildConfig.DEBUG)\n .build());\n }\n}\n\n3.1\u00a0MaterialMonitorConfig.Builder\u00a0\u53c2\u6570\u4e00\u89c8\n\u7c7b\u8def\u5f84\uff1acom.github.material.monitor.MaterialMonitorConfig\u3002\u6784\u5efa\u540e\u53ef\u901a\u8fc7\u00a0MaterialMonitor.get().getConfig()\u00a0\u8bfb\u53d6\uff1bisUploadConfigured()\u00a0\u5728\u00a0baseUploadUrl\u3001appId\u3001appKey\u00a0\u4e09\u8005\u5747\u975e\u7a7a\u65f6\u4e3a\u00a0true\uff08\u81ea\u52a8\u5165\u961f\u4e0a\u62a5\u7684\u524d\u7f6e\u6761\u4ef6\uff09\u3002\n\n\n\n Builder\u00a0\u65b9\u6cd5\n \u9ed8\u8ba4\n \u5fc5\u586b\uff08\u4e0a\u62a5\uff09\n \u8bf4\u660e\n\n\n\n\n baseUploadUrl(String)\n \"\"\n \u662f\n \u7f51\u5173\u00a0\u6839\u5730\u5740\uff0c\u4ec5\u00a0host\uff08\u53ef\u5e26\u7aef\u53e3\uff09\uff0c\u4e0d\u542b\u8def\u5f84\u3002\u5ba2\u6237\u7aef\u4f1a\u62fc\u00a0POST\u00a0{baseUploadUrl}\/v1\/creative\/upload\u3002\u793a\u4f8b\uff1ahttps:\/\/api.example.com\\\u00a0\u6216\u6d4b\u8bd5\u73af\u5883\u00a0http:\/\/dev12-cag.toponad.com\\\u3002\u9996\u5c3e\u7a7a\u767d\u4f1a\u88ab\u00a0trim\u3002\n\n\n appId(String)\n \"\"\n \u662f\n TopOn\u00a0\u5f00\u53d1\u8005\u540e\u53f0\u5206\u914d\u7684\u00a0\u5e94\u7528\u00a0ID\uff0c\u7528\u4e8e\u00a0multipart\u00a0\u8868\u5355\u5b57\u6bb5\u00a0app_id\u00a0\u4e0e\u7b7e\u540d\u3002\n\n\n appKey(String)\n \"\"\n \u662f\n \u4e0e\u00a0appId\u00a0\u914d\u5bf9\u7684\u00a0\u7b7e\u540d\u5bc6\u94a5\uff08HMAC-MD5\uff0c\u89c1\u7f51\u5173\u6587\u6863\u00a0\u00a73\uff09\u3002\u52ff\u5199\u5165\u516c\u5f00\u4ed3\u5e93\u6216\u660e\u6587\u65e5\u5fd7\uff1b\u63a8\u8350\u8fdc\u7a0b\u4e0b\u53d1\u6216\u52a0\u56fa\u5b58\u50a8\u3002\n\n\n oaid(String)\n \"\"\n \u5efa\u8bae\n \u5199\u5165\u00a0meta.device_info.oaid\u3002Android\u00a0\u533f\u540d\u8bbe\u5907\u6807\u8bc6\uff1b\u987b\u5728\u00a0\u7528\u6237\u540c\u610f\u9690\u79c1\u540e\u00a0\u7531\u5bbf\u4e3b\u91c7\u96c6\u5e76\u4f20\u5165\u3002\n\n\n androidId(String)\n \"\"\n \u53ef\u9009\n \u5199\u5165\u00a0meta.device_info.android_id\u3002\n\n\n gaid(String)\n \"\"\n \u53ef\u9009\n Google\u00a0Advertising\u00a0ID\uff0c\u5199\u5165\u00a0meta.device_info.gaid\u3002\n\n\n imei(String)\n \"\"\n \u53ef\u9009\n \u5199\u5165\u00a0meta.device_info.imei\uff1b\u53d7\u7cfb\u7edf\u7248\u672c\u4e0e\u6743\u9650\u9650\u5236\uff0c\u591a\u6570\u573a\u666f\u53ef\u4e0d\u4f20\u3002\n\n\n mac(String)\n \"\"\n \u53ef\u9009\n \u5199\u5165\u00a0meta.device_info.mac\uff1b\u5408\u89c4\u4e0a\u901a\u5e38\u00a0\u4e0d\u5efa\u8bae\u00a0\u91c7\u96c6\u3002\n\n\n maxUploadAttempts(int)\n 3\n \u5426\n \u542b\u9996\u6b21\u8bf7\u6c42\u00a0\u7684\u5355\u4efb\u52a1\u6700\u5927\u4e0a\u4f20\u6b21\u6570\uff083\u00a0=\u00a01\u00a0\u6b21\u9996\u53d1\u00a0+\u00a0\u6700\u591a\u00a02\u00a0\u6b21\u91cd\u8bd5\uff09\u3002\u4ec5\u5bf9\u00a0\u7f51\u5173\u53ef\u91cd\u8bd5\u5931\u8d25\uff08\u5982\u00a04xxx\/5xxx\uff09\u8ba1\u6570\uff1b\u65e0\u7f51\u5ef6\u540e\uff086006\uff09\u4e0d\u5360\u6b64\u9884\u7b97\uff08\u00a79.2\uff09\u3002\u8017\u5c3d\u00a0\u2192\u00a0RETRY_EXHAUSTED\uff086007\uff09\u3002\u6700\u5c0f\u503c\u4e3a\u00a01\u3002\n\n\n retryDelayMs(long\u00a0firstMs,\u00a0long\u00a0secondMs)\n 5000,\u00a015000\n \u5426\n \u7b2c\u00a01\u30012\u00a0\u6b21\u00a0\u53ef\u91cd\u8bd5\u5931\u8d25\u00a0\u540e\u7684\u7b49\u5f85\u6beb\u79d2\u6570\uff1b\u7b2c\u00a03\u00a0\u6b21\u53ca\u4ee5\u540e\u5931\u8d25\u00a0\u590d\u7528\u00a0secondMs\u3002\u4e0e\u00a04001\u00a0\u9650\u6d41\u65f6\u00a0SDK\u00a0\u4f1a\u53d6\u00a0max(\u914d\u7f6e\u5ef6\u8fdf,\u00a01s)\u3002\n\n\n connectTimeoutMs(int)\n 15000\n \u5426\n HttpURLConnection\u00a0\u8fde\u63a5\u8d85\u65f6\uff08\u6beb\u79d2\uff09\uff0c\u5185\u90e8\u00a0\u4e0b\u9650\u00a03000\u3002\n\n\n readTimeoutMs(int)\n 30000\n \u5426\n HttpURLConnection\u00a0\u8bfb\u8d85\u65f6\uff08\u6beb\u79d2\uff09\uff0c\u5185\u90e8\u00a0\u4e0b\u9650\u00a03000\u3002\n\n\n debugPerfLogging(boolean)\n false\n \u5426\n \u4e3a\u00a0true\u00a0\u65f6\u8f93\u51fa\u00a0[frame]\u00a0\/\u00a0[bitmap]\u00a0\/\u00a0[storage]\u00a0\/\u00a0[upload]\u00a0\u7b49\u5206\u9636\u6bb5\u8017\u65f6\uff08Logcat\u00a0tag\u00a0\u542b\u00a0MaterialLog@\u00a0+\u00a0\u6a21\u5757\u7248\u672c\uff09\uff0c\u8054\u8c03\u6027\u80fd\u7528\uff1bRelease\u00a0\u5efa\u8bae\u5173\u95ed\u3002\n\n\n\n\u4ec5\u91c7\u96c6\u3001\u4e0d\u4e0a\u4f20\uff1a\u53efMaterialMonitor.init(this)\u00a0\u5219\u4f7f\u7528\u9ed8\u8ba4\u7a7a\u914d\u7f6e\uff1b\u6b64\u65f6\u81ea\u52a8\u5165\u961f\u00a0\/\u00a0reportFrameRecord\u00a0\u4f1a\u56e0\u672a\u914d\u7f6e\u5b8c\u6574\u4e0a\u4f20\u53c2\u6570\u800c\u5f97\u5230\u00a0ErrorCodes.NOT_READY\uff08\u89c1\u00a0\u00a78\uff09\u3002\n\n4.\u00a0\u4f55\u65f6\u8c03\u7528\u3001delayMs\u00a0\u5efa\u8bae\u4e0e\u7279\u6b8a\u573a\u666f\n4.1\u00a0\u901a\u7528\u539f\u5219\n\u5728\u00a0\u5e7f\u544a\u5df2\u5c55\u793a\u3001\u76ee\u6807\u533a\u57df\u5df2\u00a0layout\u00a0\u5b8c\u6210\u00a0\u4e14\u4ecd\u00a0attached\u00a0\u7684\u56de\u8c03\u91cc\u8c03\u7528\uff08\u5982\u00a0onAdShow\u3001Banner\u00a0\u5c55\u793a\u56de\u8c03\u3001\u539f\u751f\u7ed1\u5b9a\u6570\u636e\u540e\uff09\u3002\nFrameOptions.delayMs\u00a0\u8868\u793a\uff1a\u4ece\u8c03\u7528\u65f6\u523b\u8d77\u518d\u7b49\u5f85\u591a\u5c11\u6beb\u79d2\u00a0\u624d\u771f\u6b63\u622a\u5c4f\uff0c\u7528\u4e8e\u9519\u5f00\u767d\u5c4f\u3001\u7d20\u6750\u6216\u89c6\u9891\u9996\u5e27\u672a\u5c31\u7eea\u3001\u5f31\u7f51\u52a0\u8f7d\u6162\u7b49\u60c5\u51b5\u3002\n4.2\u00a0\u56e0\u7f51\u7edc\u4e0e\u7d20\u6750\u52a0\u8f7d\u7684\u5ef6\u8fdf\u5efa\u8bae\uff08\u63a8\u8350\u9ed8\u8ba4\u503c\uff09\n\u7ed3\u5408\u5f31\u7f51\u4e0b\u89c6\u9891\u7c7b\u7d20\u6750\u7f13\u51b2\u66f4\u6162\u3001\u9759\u6001\u6216\u00a0HTML\u00a0\u7c7b\u76f8\u5bf9\u66f4\u5feb\u7684\u5dee\u5f02\uff0c\u5efa\u8bae\u5982\u4e0b\uff08\u53ef\u5728\u8fdc\u7a0b\u914d\u7f6e\u4e2d\u4e0b\u53d1\uff0c\u6309\u6d41\u91cf\u5206\u5c42\u5fae\u8c03\uff09\uff1a\n\n\n\n \u5e7f\u544a\u6837\u5f0f\n \u5efa\u8bae\u00a0delayMs\n \u8bf4\u660e\n\n\n\n\n \u6fc0\u52b1\u89c6\u9891\n 3000\uff5e5000\u00a0ms\n \u89c6\u9891\u6d41\u4e0e\u8d34\u7247\u5e38\u53d7\u7f51\u7edc\u5f71\u54cd\uff0c\u8fc7\u77ed\u6613\u9ed1\u5c4f\u6216\u672a\u89e3\u7801\u5e27\uff1b\u53ef\u4ece\u00a02s\u00a0\u8d77\u7ebf\u4e0a\u89c2\u5bdf\u5b8c\u6574\u7387\uff0c\u5fc5\u8981\u65f6\u63d0\u5230\u00a03\uff5e5s\n\n\n \u5f00\u5c4f\u00a0\/\u00a0Banner\u00a0\/\u00a0\u63d2\u5c4f\u00a0\/\u00a0\u539f\u751f\u7b49\u975e\u6fc0\u52b1\n \u7ea6\u00a02000\u00a0ms\n \u76f8\u5bf9\u6fc0\u52b1\u89c6\u9891\u5bf9\u300c\u9996\u5e27\u5c31\u7eea\u300d\u8981\u6c42\u7565\u4f4e\uff0c2\u00a0\u79d2\u5728\u591a\u6570\u673a\u578b\u4e0e\u7f51\u7edc\u4e0a\u53ef\u517c\u987e\u5408\u89c4\u753b\u9762\u4e0e\u4f53\u9a8c\n\n\n\n\u4ee5\u4e0a\u9488\u5bf9\u300c\u5355\u6b21\u5c55\u793a\u53ea\u622a\u4e00\u5e27\u300d\u7684\u5e38\u89c4\u76d1\u6d4b\uff1b\u4e0e\u00a0\u00a74.3\u00a0\u7684\u300c\u6fc0\u52b1\u5173\u95ed\u524d\u591a\u5e27\u300d\u53ef\u7ec4\u5408\u4f7f\u7528\u3002\n4.3\u00a0\u6fc0\u52b1\u89c6\u9891\uff1a\u5173\u95ed\u524d\u6309\u9700\u00a00\u00a0\u5ef6\u65f6\u3001\u95f4\u9694\u591a\u5e27\n\u4e3a\u66f4\u51c6\u786e\u8bc6\u522b\u00a0\u8fdd\u89c4\u753b\u9762\u3001\u5f02\u5e38\u8df3\u8f6c\u3001\u7ed3\u675f\u5e27\u8bf1\u5bfc\u00a0\u7b49\uff0c\u53ef\u5728\u00a0\u5e7f\u544a\u5373\u5c06\u5173\u95ed\u6216\u7528\u6237\u5373\u5c06\u79bb\u5f00\u00a0\u524d\uff0c\u5728\u00a0\u753b\u9762\u5df2\u7a33\u5b9a\u53ef\u89c1\u00a0\u7684\u8282\u70b9\u4e0a\uff0c\u4f7f\u7528\u00a0**delayMs(0)\u00a0\u505a\u00a0\u5373\u65f6\u622a\u5e27\uff0c\u5e76\u6309\u4e1a\u52a1\u95f4\u9694\u00a0\u591a\u6b21\u8c03\u7528\uff08\u4f8b\u5982\u6bcf\u9694\u00a05\u00a0\u79d2\u4e00\u6b21\uff0c\u6216\u5728\u00a0onReward\u3001onClose\u00a0\u524d\u4e00\u523b\u5404\u4e00\u6b21\uff09\u3002\n\u6ce8\u610f\uff1a\n\n\ndelayMs(0)\u00a0\u8868\u793a\u00a0\u4e0d\u989d\u5916\u7b49\u5f85\uff0c\u4ecd\u8981\u6c42\u8c03\u7528\u65f6\u00a0View\u00a0\u5df2\u00a0layout\u00a0\u4e14\u00a0\u4ecd\u9644\u7740\u5728\u7a97\u53e3\u4e0a\uff1b\u82e5\u8c03\u7528\u8fc7\u65e9\u4ecd\u53ef\u80fd\u5931\u8d25\uff08VIEW_INVALID\u00a0\/\u00a0\u9ed1\u5e27\uff09\uff0c\u8bf7\u628a\u300c0\u00a0\u5ef6\u65f6\u8c03\u7528\u300d\u653e\u5728\u00a0\u751f\u547d\u5468\u671f\u9760\u540e\u3001\u5185\u5bb9\u5df2\u5c55\u793a\u00a0\u7684\u56de\u8c03\u91cc\u3002\u00a0\n\n\n\u6bcf\u4e00\u6b21\u00a0collectFrameFrom*\u00a0\u90fd\u4f1a\u751f\u6210\u00a0\u65b0\u7684\u00a0FrameRecord.uploadTaskId\uff08\u961f\u5217\u5e42\u7b49\u952e\uff09\uff0c\u540c\u4e00\u5e7f\u544a\u5c55\u793a\u53ef\u591a\u6b21\u622a\u5e27\u3001\u591a\u6b21\u4e0a\u62a5\uff1b\u7f51\u5173\u4fa7\u5c55\u793a\u7ef4\u5ea6\u4ecd\u4ee5\u00a0ATAdInfo.getShowId()\u00a0\u7b49\u4e0e\u00a0meta.event_info\u00a0\u4e00\u81f4\u3002\u00a0\n\n\n\u591a\u5e27\u4f1a\u589e\u52a0\u00a0\u6d41\u91cf\u3001\u961f\u5217\u957f\u5ea6\u4e0e\u65e5\u914d\u989d\u00a0\u6d88\u8017\uff0c\u8bf7\u4e0e\u4ea7\u54c1\/\u5408\u89c4\u7ea6\u5b9a\u00a0\u9891\u6b21\u4e0a\u9650\u3002\u82e5\u6709\u591a\u5e27\u622a\u53d6\u9700\u6c42\uff0c\u5efa\u8bae5\u79d2\u4e00\u6b21\uff0c\u6309\u6700\u957f\u8fb9\u50cf\u7d20\uff08maxLongEdge\uff091080\u6807\u51c6\uff1b\u82e5\u6709\u9ad8\u9891\u9700\u6c42\uff0c\u5219\u9700\u964d\u4f4emaxLongEdge\u6807\u51c6\u5982720\u3001540\uff1b\u9ad8\u9891\u622a\u5e27\u52a8\u4f5c\u4f1a\u589e\u52a0ANR\u6216\u5185\u5b58\u4e0a\u6da8\u8fc7\u9ad8\u98ce\u9669\u3002\n\n\n\u793a\u4f8b\uff08\u4f2a\u4ee3\u7801\uff1a\u5728\u6fc0\u52b1\u5173\u95ed\u524d\u77ed\u95f4\u9694\u518d\u91c7\u4e00\u5e27\uff0cdelayMs\u00a0\u4e3a\u00a00\uff09\uff1a\nFrameOptions urgent = new FrameOptions.Builder().delayMs(0).maxSizeKb(300).build();\nMaterialMonitor.get().collectFrameFromAdContainer(rewardContainer, adInfo, timing, urgent, callback);\n\n4.4\u00a0\u539f\u751f\u81ea\u6e32\u67d3\uff1a\u6309\u7d20\u6750\u7c7b\u578b\u9009\u62e9\u91c7\u96c6\u00a0API\n\u539f\u751f\u81ea\u6e32\u67d3\u5e7f\u544a\u8bf7\u6309\u00a0\u4e3b\u7d20\u6750\u7c7b\u578b\u00a0\u9009\u7528\u00a0API\uff08Demo\u00a0\u53c2\u8003\u00a0NativeAdActivity\u00a0\u56fe\u7247\u3001NativePatchVideoActivity\u00a0\u89c6\u9891\uff09\uff1a\n\n\n\n \u7d20\u6750\u7c7b\u578b\n \u63a8\u8350\u00a0API\n \u8bf4\u660e\n\n\n\n\n \u56fe\u7247\uff08\u9759\u6001\u5927\u56fe\u7b49\uff09\n collectFrameFromNativeAdContainer\n \u4f20\u5165\u6709\u6548\u00a0http\/https\u00a0\u7684\u00a0creativeAssetUrl\uff08\u5982\u00a0getAdMaterial().getMainImageUrl()\uff09\u65f6\uff0c\u8df3\u8fc7\u672c\u5730\u622a\u5c4f\uff0c\u4ec5\u4e0a\u62a5\u00a0meta.image_url\uff08\u7f51\u5173\u00a0url-only\u00a0\u8def\u5f84\uff09\uff1b\u65e0\u6548\u6216\u975e\u00a0http(s)\u00a0URL\u00a0\u4f1a\u00a0\u56de\u9000\u00a0\u4e3a\u5bf9\u00a0targetView\u00a0\u622a\u5c4f\n\n\n \u89c6\u9891\n collectFrameFromAdContainer\n \u89c6\u9891\u5e27\u5728\u00a0SurfaceView\u00a0\/\u00a0\u786c\u4ef6\u5c42\uff0c\u9700\u8d70\u5bb9\u5668\u622a\u5c4f\u00a0+\u00a0PixelCopy\uff1b\u4e0d\u8981\u4f9d\u8d56\u9759\u6001\u4e3b\u56fe\u00a0URL\n\n\n\n\n\ncreativeAssetUrl\uff1a\u56fe\u7247\u573a\u666f\u00a0\u6709\u5219\u4f20\uff1b\u987b\u4e3a\u00a0http:\/\/\u00a0\u6216\u00a0https:\/\/\u00a0\u5f00\u5934\u3002\u7a7a\u767d\u6216\u975e\u6cd5\u534f\u8bae\u4e0d\u4f1a\u5931\u8d25\u6574\u6b21\u8c03\u7528\uff0c\u800c\u662f\u56de\u9000\u4e3a\u622a\u5c4f\u3002\u00a0\n\n\nurl-only\u00a0\u6210\u529f\u65f6\u00a0FrameRecord.file\u00a0\u4e3a\u00a0null\uff0cmultipart\u00a0\u4e0d\u542b\u00a0image\u00a0part\uff1b\u5177\u4f53\u5fc5\u586b\u89c4\u5219\u4ee5\u7f51\u5173\u6587\u6863\u4e3a\u51c6\u3002\n\n\n\n5.\u00a0API\u00a0\u53c2\u8003\uff08\u5165\u53c2\u3001\u8fd4\u56de\u503c\u4e0e\u7528\u6cd5\uff09\n\u5305\u540d\uff1acom.github.material.monitor**\u3002\u4ee5\u4e0b\u82e5\u65e0\u8bf4\u660e\uff0c\u91c7\u96c6\u76f8\u5173\u56de\u8c03\u5747\u5728\u4e3b\u7ebf\u7a0b\uff08\u89c1\u5bf9\u5916\u5b9e\u65bd\u65b9\u6848\u4e2d\u7684\u7ebf\u7a0b\u8bf4\u660e\uff09\u3002\n5.1\u00a0MaterialMonitor.init\u00a0\/\u00a0get\u00a0\/\u00a0getConfig\n\n\n\n \u65b9\u6cd5\n \u8bf4\u660e\n\n\n\n\n static\u00a0void\u00a0init(Application\u00a0application)\n \u4f7f\u7528\u9ed8\u8ba4\u00a0MaterialMonitorConfig\uff08\u65e0\u4e0a\u4f20\u53c2\u6570\uff09\u3002\u4ec5\u9002\u5408\u53ea\u843d\u76d8\u3001\u4e0d\u63a5\u7f51\u5173\u7684\u573a\u666f\u3002\n\n\n static\u00a0void\u00a0init(Application\u00a0application,\u00a0MaterialMonitorConfig\u00a0config)\n \u63a8\u8350\u3002config\u00a0\u4e0d\u53ef\u4e3a\u00a0null\u00a0\u65f6\u7528\u00a0DEFAULT\u00a0\u7b49\u4ef7\u7a7a\u914d\u7f6e\u3002\n\n\n static\u00a0MaterialMonitor\u00a0get()\n \u83b7\u53d6\u5355\u4f8b\u3002\u672a\u00a0init\u00a0\u6216\u5df2\u00a0shutdown\u00a0\u65f6\u8fd4\u56de\u00a0idle\u00a0\u5360\u4f4d\u5b9e\u4f8b\uff08collect\u00a0\u7b49\u4e3a\u00a0no-op\u00a0\u5e76\u6253\u00a0warn\u00a0\u65e5\u5fd7\uff09\uff0c\u4e0d\u629b\u5f02\u5e38\u3002\n\n\n static\u00a0boolean\u00a0isReady()\n \u662f\u5426\u5df2\u00a0init\u00a0\u4e14\u5c1a\u672a\u00a0shutdown\uff08\u771f\u5b9e\u5b9e\u4f8b\u53ef\u5728\u9996\u6b21\u00a0get()\u00a0\u65f6\u61d2\u521b\u5efa\uff09\u3002\n\n\n static\u00a0void\u00a0shutdown()\n \u91ca\u653e\u751f\u547d\u5468\u671f\u56de\u8c03\u4e0e\u00a0worker\uff1b\u5f85\u4e0a\u4f20\u00a0SQLite\u00a0\u884c\u4fdd\u7559\uff0c\u540e\u7eed\u53ef\u518d\u6b21\u00a0init\u00a0\u7eed\u4f20\u3002\n\n\n MaterialMonitorConfig\u00a0getConfig()\n \u8bfb\u53d6\u521d\u59cb\u5316\u65f6\u7684\u914d\u7f6e\uff1b\u53ef\u8c03\u7528\u00a0isUploadConfigured()\u00a0\u5224\u65ad\u662f\u5426\u5177\u5907\u00a0baseUploadUrl\u00a0+\u00a0appId\u00a0+\u00a0appKey\u3002\n\n\n\n5.2\u00a0collectFrameFromAdContainer\n\u7b7e\u540d\nvoid collectFrameFromAdContainer(\n View targetView,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n FrameCallback callback\n)\n\n\n\n\n \u53c2\u6570\n \u7c7b\u578b\n \u53ef\u5426\u00a0null\n \u8bf4\u660e\n\n\n\n\n targetView\n View\n \u5426\n \u5e7f\u544a\u5b9e\u9645\u6e32\u67d3\u533a\u57df\uff08\u5bb9\u5668\uff09\u3002\u5ef6\u65f6\u7ed3\u675f\u540e\u4f1a\u68c0\u67e5\u00a0\u4ecd\u00a0attached\uff1b\u5ef6\u65f6\u671f\u95f4\u4ec5\u00a0\u5f31\u5f15\u7528\u6301\u6709\uff0c\u907f\u514d\u6cc4\u6f0f\u3002\n\n\n adInfo\n ATAdInfo\n \u5426\n \u5f53\u524d\u5c55\u793a\u5bf9\u5e94\u7684\u00a0TopOn\u00a0\u5e7f\u544a\u4fe1\u606f\uff0c\u7528\u4e8e\u00a0placementId\u3001showId\u3001\u6837\u5f0f\u679a\u4e3e\u00a0MaterialStyle\u7b49\u3002\n\n\n timing\n AdTimingInput\n \u5426\n \u8bf7\u6c42\/\u586b\u5145\/\u5c55\u793a\u65f6\u95f4\uff08\u6beb\u79d2\uff09\uff0c\u5199\u5165\u7f51\u5173\u00a0event_info\uff08\u5e93\u5185\u8f6c\u79d2\uff09\u3002\n\n\n options\n FrameOptions\n \u53ef\n \u4f20\u00a0null\u00a0\u65f6\u4f7f\u7528\u00a0FrameOptions.defaults()\u3002\n\n\n callback\n FrameCallback\n \u53ef\n \u4f20\u00a0null\u00a0\u65f6\u65e0\u91c7\u96c6\/\u4e0a\u62a5\u56de\u8c03\uff0c\u4e00\u822c\u4e0d\u63a8\u8350\u3002\n\n\n\n\u884c\u4e3a\uff1a\u6821\u9a8c\u901a\u8fc7\u540e\u00a0postDelayed(delayMs)\uff0c\u5230\u65f6\u622a\u5c4f\u00a0\u2192\u00a0\u538b\u7f29\u5199\u76d8\u00a0\u2192\u00a0\u4e3b\u7ebf\u7a0b\u00a0onCollectSuccess\u00a0\u2192\u00a0\u82e5\u4e0a\u4f20\u5df2\u914d\u7f6e\u5219\u00a0\u81ea\u52a8\u00a0enqueueReport\u3002\u5931\u8d25\u8d70\u00a0onCollectFailure\uff08\u4e0d\u4f1a\u5165\u961f\uff09\u3002\n\u6837\u5f0f\u76ee\u5f55\uff1aMaterialStyle\u00a0\u7531\u5185\u90e8\u6839\u636e\u00a0ATAdInfo\u00a0\u89e3\u6790\uff0c\u7528\u4e8e\u672c\u5730\u5b50\u76ee\u5f55\u540d\uff08\u5982\u00a0rewarded_video\uff09\uff0c\u4e0e\u7f51\u5173\u00a0ad_type\u00a0\u542b\u4e49\u5bf9\u5e94\uff0c\u65e0\u9700\u8c03\u7528\u65b9\u4f20\u5165\u3002\n5.3\u00a0collectFrameFromNativeAdContainer\n\u7b7e\u540d\nvoid collectFrameFromNativeAdContainer(\n View targetView,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n String creativeAssetUrl,\n FrameCallback callback\n)\n\n\n\n\n \u53c2\u6570\n \u7c7b\u578b\n \u53ef\u5426\u00a0null\n \u8bf4\u660e\n\n\n\n\n targetView\u00a0\/\u00a0adInfo\u00a0\/\u00a0timing\/\u00a0options\u00a0\/\u00a0callback\n \u540c\u4e0a\n \u540c\u4e0a\n \u4e0e\u00a0collectFrameFromAdContainer\u00a0\u4e00\u81f4\u3002\n\n\n creativeAssetUrl\n String\n \u53ef\u7a7a\u5b57\u7b26\u4e32\n \u6709\u6548\u00a0http\/https\u00a0URL\u00a0\u5199\u5165\u00a0FrameRecord.imageUrl\u00a0\u4e0e\u00a0meta.image_url\uff0c\u5e76\u8d70\u00a0url-only\u00a0\u4e0a\u62a5\uff08\u4e0d\u622a\u5c4f\u3001\u4e0d\u5199\u00a0JPEG\uff09\u3002\u7a7a\u767d\u6216\u975e\u6cd5\u534f\u8bae\u00a0\u56de\u9000\u00a0\u4e3a\u5bf9\u00a0targetView\u00a0\u622a\u5c4f\uff08\u4e0e\u00a0collectFrameFromAdContainer\u00a0\u76f8\u540c\uff09\u3002\n\n\n\n\u884c\u4e3a\uff1a\u6709\u6548\u00a0URL\u00a0\u65f6\u5ef6\u65f6\u7ed3\u675f\u540e\u76f4\u63a5\u00a0onCollectSuccess\uff08file\u00a0==\u00a0null\uff09\u5e76\u5165\u961f\u00a0url-only\u00a0\u4e0a\u62a5\uff1b\u56de\u9000\u8def\u5f84\u4e0e\u5bb9\u5668\u622a\u5c4f\u4e00\u81f4\u3002\n5.4\u00a0collectFrameFromAdPage\n\u7b7e\u540d\nvoid collectFrameFromAdPage(\n Activity hostActivity,\n ATAdInfo adInfo,\n AdTimingInput timing,\n FrameOptions options,\n FrameCallback callback\n)\n\n\n\n\n \u53c2\u6570\n \u7c7b\u578b\n \u53ef\u5426\u00a0null\n \u8bf4\u660e\n\n\n\n\n hostActivity\n Activity\n \u5426\n \u8c03\u7528\u65b9\u00a0\u5f53\u524d\u9875\u9762\uff08\u5c55\u793a\u5e7f\u544a\u524d\/\u627f\u8f7d\u56de\u8c03\u7684\u00a0Activity\uff0c\u5982\u00a0Demo\u00a0\u9875\uff09\u3002\u7528\u4e8e\u5728\u5ef6\u65f6\u622a\u5c4f\u65f6\u00a0\u6392\u9664\u00a0\u8be5\u7a97\u53e3\uff0c\u907f\u514d\u900f\u660e\u00a0overlay\u00a0\u6216\u72ec\u7acb\u00a0AdActivity\u00a0\u573a\u666f\u8bef\u622a\u5230\u5bbf\u4e3b\u9875\u3002\u65e0\u6548\uff08null\u00a0\/\u00a0finishing\u00a0\/\u00a0destroyed\uff09\u2192\u00a0PARAM_INVALID\u3002\n\n\n adInfo\u00a0\/\u00a0timing\/\u00a0options\u00a0\/\u00a0callback\n \u540c\u4e0a\n \u540c\u4e0a\n \u4e0e\u5bb9\u5668\u91c7\u96c6\u4e00\u81f4\u3002\n\n\n\n\u5ef6\u65f6\u540e\u7684\u6355\u83b7\u76ee\u6807\uff08\u6309\u4f18\u5148\u7ea7\uff09\uff1a\n\n\n\u5f53\u524d\u00a0\u524d\u53f0\u00a0resumed\u00a0Activity\uff08\u5e38\u4e3a\u00a0SDK\u00a0\u72ec\u7acb\u5e7f\u544a\u9875\uff09\uff1b\n\n\n\u5426\u5219\u56de\u9000\u5230\u00a0pin\u00a0\u4f4f\u7684\u00a0hostActivity\uff1b\n\n\n\u901a\u8fc7\u00a0HostOverlayViewLocator\u00a0\u89e3\u6790\u00a0Dialog\u00a0\/\u00a0\u72ec\u7acb\u00a0Window\u00a0\/\u00a0decor\u00a0\u9876\u5c42\u00a0overlay\uff0c\u800c\u975e\u7b80\u5355\u53d6\u00a0android.R.id.content\u3002\n\n\n\u9002\u7528\uff1a\u63d2\u5c4f\/\u6fc0\u52b1\u7b49\u00a0\u65e0\u7a33\u5b9a\u4e1a\u52a1\u4fa7\u5e7f\u544a\u5bb9\u5668\u3001\u6216\u5168\u5c4f\u8986\u76d6\u96be\u4ee5\u53d6\u5b50\u00a0View\u00a0\u65f6\uff08Demo\uff1aInterstitialAdActivity\u3001RewardVideoAdActivity\u00a0\u4f20\u5165\u00a0this\uff09\u3002\n\u5931\u8d25\u5e38\u89c1\u539f\u56e0\uff1a\u5ef6\u65f6\u540e\u65e0\u53ef\u7528\u00a0Activity\u00a0\/\u00a0\u6355\u83b7\u00a0View\u00a0\u2192\u00a0ACTIVITY_INVALID\uff1b\u5f31\u5f15\u7528\u00a0Activity\u00a0\u88ab\u56de\u6536\u7b49\u3002\n\u793a\u4f8b\uff1a\nMaterialMonitor.get().collectFrameFromAdPage(\n InterstitialAdActivity.this, adInfo, timing,\n new FrameOptions.Builder().delayMs(3000).build(), callback);\n\n5.5\u00a0onAdClosed\n\u7b7e\u540d\nvoid onAdClosed(ATAdInfo adInfo)\n\n\n\n\n \u53c2\u6570\n \u8bf4\u660e\n\n\n\n\n adInfo\n \u5f53\u524d\u5173\u95ed\u7684\u5e7f\u544a\uff1b\u6309\u00a0ATAdInfo.getShowId()\u00a0\u5339\u914d\u4ecd\u5728\u00a0delayMs\u00a0\u7b49\u5f85\u4e2d\u7684\u91c7\u96c6\u4efb\u52a1\u3002\n\n\n\n\u884c\u4e3a\uff1a\u82e5\u540c\u4e00\u00a0showId\u00a0\u7684\u00a0collectFrameFromAdContainer\u00a0\u6216\u00a0collectFrameFromAdPage\u00a0\u5c1a\u672a\u6267\u884c\u622a\u5c4f\uff0c\u5219\u00a0\u53d6\u6d88\u00a0\u672c\u6b21\u91c7\u96c6\u5e76\u56de\u8c03\u00a0onCollectFailure(COLLECT_CANCELLED,\u00a0\u2026)\uff0c\u907f\u514d\u5e7f\u544a\u5df2\u5173\u4ecd\u622a\u5230\u7a7a\u767d\u6216\u5bbf\u4e3b\u9875\u3002\n\u4f55\u65f6\u8c03\u7528\uff1a\u5728\u5e7f\u544a\u00a0\u5173\u95ed\u56de\u8c03\u00a0\u4e2d\u8c03\u7528\uff08Demo\uff1aonInterstitialAdClose\u3001onRewardedVideoAdClosed\uff09\u3002Dialog\u00a0\/\u00a0overlay\u00a0\/\u00a0\u5bbf\u4e3b\u00a0Activity\u00a0\u4e0a\u5c55\u793a\u7684\u63d2\u5c4f\u00a0\u5efa\u8bae\u5fc5\u8c03\uff1b\u72ec\u7acb\u5168\u5c4f\u00a0AdActivity\u00a0\u4e14\u751f\u547d\u5468\u671f\u5df2\u8db3\u591f\u65f6\u53ef\u7701\u7565\u3002\n@Override\npublic void onInterstitialAdClose(ATAdInfo adInfo) {\n MaterialMonitor.get().onAdClosed(adInfo);\n}\n\n5.6\u00a0reportFrameRecord\n\u7b7e\u540d\nvoid reportFrameRecord(FrameRecord record, ATAdInfo adInfo)\nvoid reportFrameRecord(FrameRecord record, ATAdInfo adInfo, ReportCallback callback)\n\n\n\n\n \u53c2\u6570\n \u8bf4\u660e\n\n\n\n\n record\n \u622a\u5c4f\u8def\u5f84\u987b\u542b\u00a0\u5df2\u5b58\u5728\u00a0\u7684\u672c\u5730\u00a0JPEG\u00a0file\uff1burl-only\u00a0\u91c7\u96c6\u65f6\u00a0file\u00a0\u4e3a\u00a0null\uff0c\u7531\u00a0collectFrameFromNativeAdContainer\u00a0\u81ea\u52a8\u5165\u961f\uff0c\u4e00\u822c\u65e0\u9700\u624b\u52a8\u8c03\u7528\u3002uploadTaskId\u00a0\u4e3a\u7a7a\u65f6\u5165\u961f\u4f1a\u751f\u6210\u00a0\u65b0\u00a0task_id\u3002\n\n\n adInfo\n \u4e0e\u5f53\u65f6\u5c55\u793a\u4e00\u81f4\uff0c\u7528\u4e8e\u7ec4\u88c5\u00a0meta\u00a0\u4e2d\u5e7f\u544a\u5b57\u6bb5\u3002\n\n\n callback\n \u4ec5\u4e0a\u62a5\u7ed3\u679c\uff1aonReportSuccess\u00a0\/\u00a0onReportSkip\u00a0\/\u00a0onReportFailure\uff08\u65e0\u00a0onCollect\uff09\u3002\n\n\n\n\u5178\u578b\u7528\u9014\uff1a\u5148\u91c7\u96c6\u843d\u76d8\u3001\u540e\u62e9\u673a\u4e0a\u4f20\uff1b\u6216\u91c7\u96c6\u6210\u529f\u4f46\u6b64\u524d\u4e0a\u4f20\u5931\u8d25\u540e\u7684\u8865\u4f20\uff08\u6ce8\u610f\u00a0uploadTaskId\u00a0\u4e0e\u91cd\u590d\u5165\u961f\u8bed\u4e49\uff09\u3002\n5.7\u00a0flushPendingFrames\nvoid flushPendingFrames()\n\n\u4f5c\u7528\uff1a\u4e3b\u52a8\u8bf7\u6c42\u6a21\u5757\u00a0\u5c3d\u5feb\u5904\u7406\u4e00\u6b21\u00a0SQLite\u00a0\u4e2d\u4ecd\u5b58\u5728\u7684\u00a0\u5f85\u4e0a\u4f20\u4efb\u52a1\uff08\u5185\u90e8\u4f1a\u8c03\u5ea6\u4e0a\u4f20\u6267\u884c\u5668\u91cc\u7684\u00a0drain\uff0c\u4e0e\u300c\u65b0\u4efb\u52a1\u5165\u961f\u300d\u89e6\u53d1\u7684\u5904\u7406\u540c\u6e90\uff09\u3002\u53ef\u4ece\u4efb\u610f\u7ebf\u7a0b\u8c03\u7528\uff0c\u5185\u90e8\u4f1a\u5207\u5230\u4e0a\u4f20\u7ebf\u7a0b\u4e0e\u4e3b\u7ebf\u7a0b\u00a0Handler\uff0c\u4e0d\u4f1a\u5728\u8c03\u7528\u7ebf\u7a0b\u4e0a\u505a\u00a0HTTP\u3002\n\u5178\u578b\u4f7f\u7528\u573a\u666f\uff08\u6309\u9700\u9009\u7528\uff1b\u4e0e\u300c\u65b0\u4efb\u52a1\u5165\u961f\u81ea\u52a8\u00a0drain\u300d\u53e0\u52a0\u4e00\u822c\u65e0\u5bb3\uff09\uff1a\n\n\n\n \u573a\u666f\n \u8bf4\u660e\n\n\n\n\n \u7f51\u7edc\u4ece\u4e0d\u53ef\u7528\u5230\u53ef\u7528\n \u65e0\u7f51\u3001NETWORK_ERROR\u00a0\u5ef6\u540e\u8def\u5f84\u4e0b\u4efb\u52a1\u4ecd\u5728\u5e93\u4e2d\uff1b\u5728\u00a0NetworkCallback.onAvailable\u3001\u6216\u81ea\u5efa\u300c\u5df2\u8054\u7f51\u300d\u5224\u65ad\u91cc\u8c03\u7528\uff0c\u53ef\u7f29\u77ed\u7b49\u5230\u4e0b\u4e00\u6b21\u00a0\u7ea6\u00a030s\u00a0\u5b9a\u65f6\u63a2\u6d4b\u7684\u95f4\u9694\u3002\n\n\n \u7528\u6237\u6253\u5f00\u00a0Wi\u2011Fi\u00a0\/\u00a0\u8702\u7a9d\u540e\u56de\u5230\u00a0App\n \u5728\u00a0onResume\u00a0\u6216\u7f51\u7edc\u56de\u8c03\u91cc\u00a0flushPendingFrames()\u3002\n\n\n \u65e5\u914d\u989d\u00a0\/\u00a0\u9650\u6d41\u89e3\u9664\u540e\n \u5c01\u7981\u7a97\u53e3\u8fc7\u540e\u53ef\u914d\u5408\u4e1a\u52a1\u5224\u65ad\u518d\u00a0flush\u3002\n\n\n\n\u4e00\u822c\u4e0d\u5fc5\uff1a\u4ec5\u4f9d\u8d56\u8fdb\u7a0b\u5185\u00a0\u5165\u961f\u00a0\/\u00a0init\u00a0\u65f6\u7684\u81ea\u52a8\u00a0drain\u00a0\u4e5f\u80fd\u5728\u6062\u590d\u7f51\u7edc\u540e\u9646\u7eed\u4e0a\u4f20\uff1b\u65e0\u5168\u5c40\u7f51\u7edc\u76d1\u542c\u65f6\uff0c\u81f3\u5c11\u5728\u00a0\u7f51\u7edc\u53ef\u7528\u56de\u8c03\u00a0+\u00a0\u4e3b\u00a0Activity\u00a0onResume\u00a0\u8c03\u7528\u5373\u53ef\u3002\n\u4e0e\u300c\u65e0\u7f51\u5ef6\u540e\u300d\u7684\u5173\u7cfb\uff1aflush\u00a0\u53ea\u5524\u9192\u4e0a\u4f20\u961f\u5217\uff0c\u4e0d\u91cd\u65b0\u622a\u5c4f\uff1b\u65e0\u7f51\u65f6\u00a0drain\u00a0\u5185\u4ecd\u4f1a\u9884\u68c0\u5931\u8d25\u5e76\u518d\u6b21\u6392\u7a0b\uff0c\u4f46\u6bd4\u5e72\u7b49\u5b9a\u65f6\u5668\u66f4\u53ca\u65f6\u3002\n\u6ce8\u610f\uff1aflush\u00a0\u4e0d\u7ed5\u8fc7\u65e5\u914d\u989d\u95e8\uff1b\u672c\u5730\u6587\u4ef6\u5df2\u5220\u6216\u4efb\u52a1\u5df2\u7ec8\u6001\u5219\u65e0\u4e0a\u4f20\u53ef\u505a\u3002\u65e0\u7f51\u5ef6\u540e\u3001\u56de\u8c03\u8bed\u4e49\u7b49\u89c1\u00a0\u00a79\u3002\n5.8\u00a0getRecords\u00a0\/\u00a0deleteRecord\nList getRecords(MaterialStyle style)\nboolean deleteRecord(FrameRecord record)\n\n\n\n\n \u65b9\u6cd5\n \u8bf4\u660e\n\n\n\n\n getRecords\n \u679a\u4e3e\u67d0\u00a0MaterialStyle\u00a0\u5bf9\u5e94\u76ee\u5f55\u4e0b\u5386\u53f2\u00a0JPEG\u00a0\u6587\u4ef6\uff1b\u8fd4\u56de\u7684\u00a0FrameRecord\u00a0\u90e8\u5206\u5b57\u6bb5\u53ef\u80fd\u4e3a\u5360\u4f4d\uff08\u4ec5\u4fdd\u8bc1\u00a0style\u4e0e\u00a0file\u00a0\u7b49\u6587\u4ef6\u7ea7\u4fe1\u606f\uff09\uff0c\u4e0d\u5b9c\u5f53\u4f5c\u5b8c\u6574\u4e0a\u62a5\u5143\u6570\u636e\u552f\u4e00\u6765\u6e90\u3002\n\n\n deleteRecord\n \u5148\u53d6\u6d88\u4e0e\u8be5\u00a0FrameRecord\u00a0\u7684\u00a0uploadTaskId\u00a0\u6216\u672c\u5730\u8def\u5f84\u5339\u914d\u7684\u00a0\u5f85\u4e0a\u4f20\u4efb\u52a1\uff0c\u518d\u5220\u6587\u4ef6\uff0c\u907f\u514d\u961f\u5217\u4e0e\u78c1\u76d8\u4e0d\u4e00\u81f4\u3002\n\n\n\nMaterialStyle\u00a0\u679a\u4e3e\uff1aSPLASH\u3001BANNER\u3001INTERSTITIAL\u3001REWARDED_VIDEO\u3001NATIVE\uff08\u4e0e\u6587\u4ef6\u5939\u540d\u4e00\u81f4\uff0c\u89c1\u6e90\u7801\u00a0getFolderName()\uff09\u3002\n\n6.\u00a0FrameOptions\u00a0\u4e0e\u00a0AdTimingInput\n6.1\u00a0FrameOptions.Builder\n\n\n\n \u65b9\u6cd5\u00a0\/\u00a0\u5b57\u6bb5\n \u9ed8\u8ba4\n \u8bf4\u660e\n\n\n\n\n delayMs(long)\n 500\n \u2265\u00a00\u3002\u5efa\u8bae\u6309\u00a0\u00a74.2\u00a0\u8c03\u6574\uff1a\u6fc0\u52b1\u00a02\uff5e5s\uff0c\u5176\u4ed6\u00a0\u7ea6\u00a02s\uff1b\u5173\u95ed\u524d\u5b9a\u70b9\u53ef\u7528\u00a00\u3002\n\n\n maxSizeKb(int)\n 300\n \u8f93\u51fa\u00a0JPEG\u00a0\u4e0a\u9650\uff0c\u4e0e\u7f51\u5173\u300c\u5355\u56fe\u00a0\u2264300KB\u300d\u5bf9\u9f50\uff1b\u5141\u8bb8\u8303\u56f4\u00a080,\u00a0300\uff08\u8d85\u51fa\u4f1a\u88ab\u00a0clamp\uff09\u3002\n\n\n maxLongEdge(int)\n 1080\n \u6700\u957f\u8fb9\u50cf\u7d20\u4e0a\u9650\uff1b\u5141\u8bb8\u00a0540,\u00a01440\uff08\u8d85\u51fa\u4f1a\u88ab\u00a0clamp\uff09\u3002\u9ed8\u8ba4\u00a01080\u00a0\u5728\u00a0300KB\u00a0\u7f51\u5173\u9650\u5236\u4e0e\u5ba1\u6838\u53ef\u8bfb\u6027\u4e4b\u95f4\u6298\u4e2d\uff1b\u8bc6\u522b\u8981\u6c42\u66f4\u9ad8\u53ef\u8c03\u81f3\u00a01440\u00a0\u5e76\u9a8c\u8bc1\u00a0JPEG\u00a0\u4f53\u79ef\u3002\u82e5\u622a\u5e27\u9891\u7387\u9ad8\u5219\u503e\u5411720\u00a0\u6216\u00a0\u66f4\u4f4e\n\n\n keepQualityFirst(boolean)\n true\n \u4f18\u5148\u8f83\u9ad8\u00a0JPEG\u00a0\u8d28\u91cf\u518d\u964d\u8d28\u91cf\/\u7f29\u5c0f\uff0c\u76f4\u5230\u6ee1\u8db3\u00a0maxSizeKb\u3002\n\n\n\n\u6784\u5efa\uff1anew\u00a0FrameOptions.Builder().delayMs(2000).maxSizeKb(300).build()\u3002\n6.2\u00a0AdTimingInput\n\n\n\n \u6784\u9020\u00a0\/\u00a0\u5de5\u5382\n \u8bf4\u660e\n\n\n\n\n new\u00a0AdTimingInput(requestTimeMs,\u00a0fillTimeMs,\u00a0showTimeMs)\n \u6beb\u79d2\uff1b\u5199\u5165\u00a0meta.event_info\u00a0\u65f6\u8f6c\u4e3a\u79d2\u3002\n\n\n\n\u7f51\u5173\u5bf9\u00a0request_ts\u00a0\/\u00a0fill_ts\u00a0\/\u00a0show_ts\u00a0\u7684\u5fc5\u586b\u8bed\u4e49\u4ee5\u5bf9\u63a5\u6587\u6863\u4e3a\u51c6\uff1b\u5e93\u5185\u5bf9\u00a0\u22640\u00a0\u7684\u9879\u4f1a\u6309\u00a0show_ts\u00a0\u7b49\u540c\u79d2\u505a\u56de\u586b\uff08\u89c1\u00a0CreativeMetaBuilder\uff09\uff0c\u751f\u4ea7\u73af\u5883\u4ecd\u5efa\u8bae\u4f20\u5165\u771f\u5b9e\u4e09\u9636\u6bb5\u65f6\u95f4\u3002\n\n7.\u00a0\u56de\u8c03\u8bf4\u660e\uff08FrameCallback\u00a0\/\u00a0AbstractFrameCallback\uff09\nAbstractFrameCallback() {\n @Override\n public void onCollectSuccess(FrameRecord record) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u622a\u5c4f\u6210\u529f\u65f6 file \u5df2\u5199\u597d\uff1burl-only \u65f6 file \u4e3a null\u3001\u4ec5\u5e26 image_url\n }\n\n @Override\n public void onCollectFailure(int errorCode, String message, Throwable cause) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u672a\u5165\u961f\u4e0a\u4f20\n }\n\n @Override\n public void onReportSuccess(FrameRecord record) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u4e0a\u4f20\u6210\u529f\uff1brecord.getFile() \u901a\u5e38\u4e3a null\uff08\u5e93\u5df2\u5220 JPEG\uff09\n }\n\n @Override\n public void onReportSkip(FrameRecord record, String reason) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1a\u91cd\u590d task\u3001\u914d\u989d\u5c01\u7981\u7b49\n }\n\n @Override\n public void onReportFailure(int errorCode, String message, FrameRecord record, Throwable cause) {\n \/\/ \u4e3b\u7ebf\u7a0b\uff1arecord \u53ef\u80fd\u4e3a null\uff08\u7ec8\u7aef\u5931\u8d25\u4e14\u5df2\u6e05\u7406\uff09\n }\n }\n\nMaterialMonitor.get().collectFrameFromAdContainer(target, adInfo, AdTimingTracker.mock(), options,\n MaterialMonitorHelper.demoFrameCallback(this));\n\n\u82e5frameCallback\u9700\u8981\u6301\u6709activity\uff0c\u4e3a\u907f\u514d\u5185\u5b58\u6cc4\u6f0f\u63a8\u8350\u4e24\u79cd\u4f7f\u7528\u8def\u5f84\uff1a\u00a0\n\n\nstatic\u00a0\u5185\u90e8\u7c7b\u00a0+\u00a0\u5f15\u7528\u00a0Activity.this\u65b9\u5f0f\uff1a\u53c2\u8003MaterialMonitorHelper.demoFrameCallback(activity)\u00a0\u5f31\u5f15\u7528\u6301\u6709activity\uff1b\n\n\n\u533f\u540d\u00a0\/\u00a0\u975e\u00a0static\u00a0\u5185\u90e8\u7c7b\u00a0+\u00a0\u5f3a\u5f15\u7528\u00a0Activity.this\u65b9\u5f0f\uff1a\u53ef\u5728activity\u00a0onDestroy\u00a0\u5bf9\u63a5\u00a0\u4f20\u5165\u4e0e\u00a0collect\u00a0\u7684\u540c\u4e00\u5b9e\u4f8b\u00a0frameCallback\uff1a\n\n\n MaterialMonitor.get().detachCallback(frameCallback);\n\n\n8.\u00a0\u9519\u8bef\u7801\u901f\u67e5\uff08com.github.material.monitor.ErrorCodes\uff09\nSDK\u00a0\u56de\u8c03\u91cc\u7684\u00a0errorCode\u00a0\u5747\u4e3a\u00a06xxx\u00a0\u7aef\u4fa7\u7801\uff0c\u4e0e\u7f51\u5173\u00a0HTTP\u00a0\u54cd\u5e94\u00a0JSON\u00a0\u7684\u00a0code\uff081xxx\uff5e5xxx\uff09\u4e0d\u662f\u540c\u4e00\u5957\u6570\u503c\u3002\u6392\u67e5\u7f51\u5173\u95ee\u9898\u65f6\uff0c\u8bf7\u770b\u5931\u8d25\u00a0message\u00a0\u91cc\u7684\u00a0gateway\u00a0NNNN:\u00a0\u2026\u00a0\u524d\u7f00\uff0c\u5e76\u5bf9\u7167\u00a0CreativeAuditGateway\u00a0-\u00a0SDK\u5bf9\u63a5\u6587\u6863\u3002\n8.1\u00a0\u7aef\u4fa7\u9519\u8bef\u7801\u4e00\u89c8\n\n\n\n \u7801\n \u5e38\u91cf\n \u56de\u8c03\n \u7ec8\u7aef\n \u542b\u4e49\u4e0e\u5904\u7406\u5efa\u8bae\n\n\n\n\n 6001\n VIEW_INVALID\n onCollectFailure\n \u662f\n \u5bb9\u5668\u4e3a\u7a7a\u3001\u672a\u00a0attach\uff0c\u6216\u00a0delayMs\u00a0\u540e\u00a0View\u00a0\u5df2\u9500\u6bc1\u00a0\u2192\u00a0\u5728\u00a0\u5c55\u793a\u4e14\u4ecd\u00a0attached\u00a0\u7684\u56de\u8c03\u91cc\u8c03\u7528\uff1b\u9002\u5f53\u589e\u5927\u00a0delayMs\n\n\n 6002\n ACTIVITY_INVALID\n onCollectFailure\n \u662f\n \u5168\u5c4f\u91c7\u96c6\u5ef6\u65f6\u540e\u65e0\u53ef\u7528\u9875\u9762\u00a0\u2192\u00a0collectFrameFromAdPage\u00a0\u4f20\u5165\u6709\u6548\u00a0hostActivity\uff1b\u786e\u8ba4\u5e7f\u544a\u9875\u4ecd\u5728\u524d\u53f0\n\n\n 6003\n COLLECTION_FAILED\n onCollectFailure\n \u662f\n \u622a\u5c4f\u5931\u8d25\uff08\u542b\u00a0PixelCopy\u00a0\u5931\u8d25\uff09\u2192\u00a0\u89c6\u9891\u7c7b\u7528\u5bb9\u5668\u00a0API\uff1b\u4f4e\u7248\u672c\u53ef\u80fd\u53ea\u80fd\u00a0View.draw\uff0c\u53ef\u589e\u5927\u00a0delayMs\n\n\n 6004\n COMPRESS_FAILED\n onCollectFailure\n \u662f\n JPEG\u00a0\u8d85\u00a0maxSizeKb\u00a0\u9884\u7b97\u00a0\u2192\u00a0\u964d\u4f4e\u00a0maxLongEdge\u00a0\u6216\u00a0maxSizeKb\uff0c\u6216\u7f29\u5c0f\u622a\u5e27\u533a\u57df\n\n\n 6005\n PARAM_INVALID\n onCollectFailure\u00a0\/\u00a0onReportFailure\n \u662f\n \u5165\u53c2\u4e0d\u5408\u6cd5\uff08adInfo\/timing\/hostActivity\u00a0\u7b49\uff09\u6216\u00a0reportFrameRecord\u00a0\u65f6\u672c\u5730\u6587\u4ef6\u4e0d\u5b58\u5728\n\n\n 6006\n NETWORK_ERROR\n onReportFailure\n \u5426\n \u65e0\u7f51\u6216\u4f20\u8f93\u5931\u8d25\uff1b\u4efb\u52a1\u4ecd\u6392\u961f\uff0c\u4e0d\u5360\u91cd\u8bd5\u4e0a\u9650\u00a0\u2192\u00a0\u6062\u590d\u7f51\u7edc\u540e\u00a0flushPendingFrames()\uff08\u00a79.2\uff09\uff1b\u6210\u529f\u540e\u4ecd\u53ef\u80fd\u00a0onReportSuccess\n\n\n 6007\n RETRY_EXHAUSTED\n onReportFailure\n \u662f\n \u4e0a\u4f20\u91cd\u8bd5\u8017\u5c3d\u00a0\u2192\u00a0\u67e5\u00a0message\u00a0\u4e2d\u7f51\u5173\u7801\uff1b\u9700\u8865\u4f20\u65f6\u7528\u65b0\u00a0uploadTaskId\u00a0\u91cd\u65b0\u00a0reportFrameRecord\u00a0\u6216\u91cd\u65b0\u91c7\u96c6\n\n\n 6008\n NOT_READY\n onCollectFailure\u00a0\/\u00a0onReportFailure\n \u662f\n \u672a\u00a0init\u3001\u5df2\u00a0shutdown\uff0c\u6216\u00a0baseUploadUrl\/appId\/appKey\u00a0\u672a\u914d\u9f50\n\n\n 6009\n COLLECT_CANCELLED\n onCollectFailure\n \u662f\n \u5ef6\u65f6\u672a\u622a\u5c4f\u524d\u5e7f\u544a\u5df2\u5173\uff08onAdClosed\uff09\u2192\u00a0\u9884\u671f\u884c\u4e3a\uff1b\u5173\u95ed\u56de\u8c03\u4e2d\u8c03\u7528\u00a0onAdClosed\u00a0\u53ef\u907f\u514d\u8bef\u91c7\n\n\n\n8.2\u00a0\u56de\u8c03\u4e0e\u9519\u8bef\u7801\n\n\n\n \u56de\u8c03\n \u8bf4\u660e\n\n\n\n\n onCollectFailure\n \u91c7\u96c6\/\u5199\u76d8\u5931\u8d25\uff0c\u6216\u00a0onAdClosed\u00a0\u53d6\u6d88\uff1b\u4e0d\u4f1a\u81ea\u52a8\u5165\u961f\u4e0a\u4f20\n\n\n onReportFailure\n \u4e0a\u62a5\u94fe\u5931\u8d25\uff1b6006\u00a0\u4e3a\u975e\u7ec8\u7aef\uff0c\u5176\u4f59\u591a\u4e3a\u7ec8\u7aef\uff08\u672c\u5730\u4efb\u52a1\u53ef\u80fd\u5df2\u6e05\u7406\uff09\n\n\n onReportSkip\n \u4e0d\u662f\u9519\u8bef\u7801\uff1b\u5982\u65e5\u914d\u989d\u5c01\u7981\u3001\u91cd\u590d\u00a0uploadTaskId\uff0c\u770b\u00a0reason\u00a0\u5b57\u7b26\u4e32\n\n\n\n\u91c7\u96c6\u00a0vs\u00a0\u4e0a\u62a5\uff1a6001\uff5e6004\u30016009\u00a0\u53ea\u51fa\u73b0\u5728\u00a0onCollectFailure\uff1b6005\uff5e6008\u00a0\u4e3b\u8981\u51fa\u73b0\u5728\u00a0onReportFailure\uff086005\u00a0\u4e5f\u53ef\u80fd\u5728\u91c7\u96c6\u5165\u53e3\u89e6\u53d1\uff09\u3002\n8.3\u00a0\u7f51\u5173\u00a0code\u00a0\u4e0e\u7aef\u4fa7\u00a0errorCode\n\n\n\n \u4f60\u770b\u5230\u7684\n \u8bf4\u660e\n\n\n\n\n \u56de\u8c03\u00a0errorCode\uff086xxx\uff09\n SDK\u00a0\u91c7\u96c6\u94fe\u53ca\u65e0\u00a0HTTP\u00a0\u54cd\u5e94\u65f6\u7684\u4e0a\u62a5\u9519\u8bef\uff08\u5982\u00a06006\u00a0\u65e0\u7f51\uff09\n\n\n \u56de\u8c03\u00a0errorCode\uff081xxx\uff5e5xxx\uff09\n \u90e8\u5206\u00a0\u7f51\u5173\u7ec8\u6001\u5931\u8d25\u00a0\u65f6\uff0cerrorCode\u00a0\u53ef\u80fd\u4e0e\u54cd\u5e94\u00a0body\u00a0\u7684\u00a0code\u00a0\u76f8\u540c\uff1b\u4ecd\u5efa\u8bae\u4ee5\u00a0message\u00a0\u4e3a\u51c6\n\n\n message\u00a0\u4e2d\u00a0gateway\u00a0NNNN:\n \u7f51\u5173\u539f\u59cb\u534f\u8bae\u7801\u4e0e\u6587\u6848\uff0c\u8054\u8c03\u65f6\u00a0\u4f18\u5148\u89e3\u6790\u6b64\u5b57\u6bb5\n\n\n \u54cd\u5e94\u00a0body\u00a0trace_id\n \u6210\u529f\/\u5931\u8d25\u5747\u53ef\u80fd\u8fd4\u56de\uff0c\u8054\u7cfb\u00a0TopOn\u00a0\u6280\u672f\u652f\u6301\u65f6\u4e00\u5e76\u63d0\u4f9b\n\n\n\n\u4e0d\u8981\u628a\u00a06xxx\u00a0\u7aef\u4fa7\u7801\u4e0e\u7f51\u5173\u00a01xxx\uff5e5xxx\u00a0\u6df7\u5728\u540c\u4e00\u5957\u57cb\u70b9\u679a\u4e3e\u91cc\u3002\u7f51\u5173\u7801\u5b8c\u6574\u8868\u89c1\u00a0\u00a78.4\u3002\n8.4\u00a0\u7f51\u5173\u54cd\u5e94\u9519\u8bef\u7801\uff08CreativeAuditGateway\uff09\n\u4e0a\u4f20\u63a5\u53e3\u00a0POST\u00a0\u2026\/v1\/creative\/upload\u00a0\u8fd4\u56de\u00a0JSON\uff0ccode\u00a0==\u00a00\u00a0\u8868\u793a\u6210\u529f\uff08HTTP\u00a0\u901a\u5e38\u4e3a\u00a0200\uff09\u3002\u5931\u8d25\u65f6\u00a0code\u00a0\u4e3a\u975e\u00a00\uff0c\u4e14\u00a0trace_id\u00a0\u5728\u6210\u529f\u4e0e\u5931\u8d25\u65f6\u5747\u53ef\u80fd\u8fd4\u56de\uff0c\u8bf7\u5931\u8d25\u65f6\u843d\u65e5\u5fd7\u4fbf\u4e8e\u6392\u67e5\u3002\n\n\u4ee5\u4e0b\u4e0e\u00a0document\/CreativeAuditGateway\u00a0-\u00a0SDK\u5bf9\u63a5\u6587\u6863.md\u00a0\u00a7\u516b\u00a0\u4e00\u81f4\uff1b\u82e5\u7f51\u5173\u7248\u672c\u6709\u589e\u5220\uff0c\u4ee5\u5728\u7ebf\u63a5\u53e3\u8bf4\u660e\u4e3a\u51c6\u3002\n\n8.4.1\u00a0\u6210\u529f\n\n\n\n code\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n\n\n\n\n 0\n ok\n \u4e0a\u4f20\u6210\u529f\uff1b\u540c\u4e00\u00a0event_info.show_id\u00a0\u91cd\u590d\u4e0a\u62a5\u4e5f\u8fd4\u56de\u00a00\uff08\u5e42\u7b49\uff0c\u4e0d\u91cd\u590d\u6263\u914d\u989d\uff09\n\n\n\n8.4.2\u00a01xxx\u00a0\u2014\u00a0\u9274\u6743\u9519\u8bef\uff08\u4e0d\u53ef\u91cd\u8bd5\uff09\n\n\n\n code\n HTTP\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n \u5efa\u8bae\u5904\u7406\n\n\n\n\n 1001\n 401\n unauthorized\n \u7b7e\u540d\u6821\u9a8c\u5931\u8d25\u6216\u00a0app_id\u00a0\u65e0\u6548\n \u68c0\u67e5\u00a0appKey\u3001\u7b7e\u540d\u7b97\u6cd5\u3001appId\n\n\n 1002\n 403\n forbidden\n \u672a\u5f00\u901a\u7d20\u6750\u76d1\u6d4b\u80fd\u529b\n \u8054\u7cfb\u00a0TopOn\u00a0\u8fd0\u8425\u5f00\u901a\n\n\n\n8.4.3\u00a02xxx\u00a0\u2014\u00a0\u53c2\u6570\u00a0\/\u00a0\u56fe\u7247\u9519\u8bef\uff08\u4e0d\u53ef\u91cd\u8bd5\uff09\n\n\n\n code\n HTTP\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n \u5efa\u8bae\u5904\u7406\n\n\n\n\n 2001\n 400\n invalid\u00a0params\n meta\u00a0\u5fc5\u586b\u5b57\u6bb5\u7f3a\u5931\u6216\u683c\u5f0f\u9519\u8bef\n \u6838\u5bf9\u00a0ATAdInfo\u3001AdTimingInput\u3001\u8bbe\u5907\u5b57\u6bb5\n\n\n 2002\n 400\n image\u00a0too\u00a0large\n JPEG\u00a0\u8d85\u8fc7\u00a0300KB\n \u964d\u4f4e\u00a0maxSizeKb\u00a0\/\u00a0maxLongEdge\n\n\n 2003\n 400\n invalid\u00a0image\u00a0format\n \u975e\u00a0JPEG\n \u786e\u8ba4\u622a\u5c4f\u8f93\u51fa\u4e3a\u00a0JPEG\n\n\n 2005\n 400\n request\u00a0body\u00a0too\u00a0large\n \u6574\u5305\u8d85\u8fc7\u00a0512KB\n \u7f29\u5c0f\u56fe\u7247\u6216\u8d70\u00a0url-only\n\n\n\n8.4.4\u00a03xxx\u00a0\u2014\u00a0\u914d\u989d\u9519\u8bef\uff08\u5f53\u65e5\u4e0d\u518d\u4e0a\u62a5\uff09\n\n\n\n code\n HTTP\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n \u5efa\u8bae\u5904\u7406\n\n\n\n\n 3001\n 429\n account\u00a0quota\u00a0exceeded\n \u5e10\u6237\u6bcf\u65e5\u914d\u989d\u7528\u5b8c\n \u5f53\u5929\u505c\u6b62\u4e0a\u62a5\uff1b\u54cd\u5e94\u6216\u00a0onReportSkip\/reason\u00a0\u4e2d\u53ef\u80fd\u6709\u00a0daily_quota_reset_at\n\n\n 3002\n 429\n app\u00a0quota\u00a0exceeded\n App\u00a0\u6bcf\u65e5\u914d\u989d\u7528\u5b8c\n \u540c\u4e0a\uff0c\u9488\u5bf9\u5355\u4e2a\u00a0App\n\n\n\n8.4.5\u00a04xxx\u00a0\u2014\u00a0\u9650\u6d41\uff08\u53ef\u91cd\u8bd5\uff09\n\n\n\n code\n HTTP\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n \u5efa\u8bae\u5904\u7406\n\n\n\n\n 4001\n 429\n rate\u00a0limit\u00a0exceeded\n \u8bf7\u6c42\u9891\u7387\u8fc7\u9ad8\n \u7b49\u5f85\u54cd\u5e94\u00a0Header\u00a0Retry-After\uff08\u901a\u5e38\u00a0\u22651s\uff09\u540e\u91cd\u8bd5\n\n\n\n8.4.6\u00a05xxx\u00a0\u2014\u00a0\u670d\u52a1\u7aef\u9519\u8bef\uff08\u53ef\u91cd\u8bd5\uff09\n\n\n\n code\n HTTP\n msg\uff08\u793a\u4f8b\uff09\n \u8bf4\u660e\n \u5efa\u8bae\u5904\u7406\n\n\n\n\n 5001\n 500\n upload\u00a0failed\n \u670d\u52a1\u7aef\u5b58\u50a8\u5f02\u5e38\n SDK\u00a0\u81ea\u52a8\u91cd\u8bd5\uff1b\u4ecd\u5931\u8d25\u5219\u00a0RETRY_EXHAUSTED\uff086007\uff09\n\n\n 5002\n 500\n internal\u00a0error\n \u670d\u52a1\u7aef\u5185\u90e8\u9519\u8bef\n \u540c\u4e0a\n\n\n 5003\n 502\n image\u00a0download\u00a0failed\n meta.image_url\u00a0\u4e0b\u8f7d\u5931\u8d25\n \u68c0\u67e5\u00a0URL\u00a0\u53ef\u8bbf\u95ee\u6027\uff08\u539f\u751f\u00a0url-only\uff09\n\n\n 5004\n 503\n service\u00a0unavailable\n \u670d\u52a1\u6682\u4e0d\u53ef\u7528\n \u7a0d\u540e\u91cd\u8bd5\n\n\n\n8.4.7\u00a0material-monitor\u00a0\u5bf9\u7f51\u5173\u7801\u7684\u5904\u7406\n\n\n\n \u7f51\u5173\u00a0code\n SDK\u00a0\u884c\u4e3a\n \u5bbf\u4e3b\u56de\u8c03\n\n\n\n\n 0\n \u5220\u672c\u5730\u00a0JPEG\u00a0\u4e0e\u961f\u5217\u884c\n onReportSuccess\n\n\n 1001\uff5e1002\u30012001\uff5e2005\n \u7ec8\u7aef\u5931\u8d25\uff0c\u6e05\u7406\u672c\u5730\u4efb\u52a1\n onReportFailure\uff1bmessage\u00a0\u542b\u00a0gateway\u00a0NNNN:\u00a0\u2026\n\n\n 3001\uff5e3002\n \u5199\u5165\u65e5\u914d\u989d\u5c01\u7981\u7a97\u53e3\uff0c\u6e05\u7406\u5f53\u524d\u4efb\u52a1\n onReportFailure\u00a0\u6216\u540e\u7eed\u65b0\u4efb\u52a1\u00a0onReportSkip\uff08reason\u00a0\u542b\u00a0daily_quota_reset_at\uff09\n\n\n 4001\u30015001\uff5e5004\n \u6309\u00a0maxUploadAttempts\u00a0\u81ea\u52a8\u91cd\u8bd5\uff084001\u00a0\u81f3\u5c11\u7b49\u5f85\u00a01s\uff09\n \u91cd\u8bd5\u671f\u95f4\u901a\u5e38\u00a0\u65e0\u00a0\u5931\u8d25\u56de\u8c03\uff1b\u8017\u5c3d\u540e\u00a0onReportFailure(6007,\u00a0\u2026)\n\n\n \u65e0\u00a0HTTP\u00a0\u54cd\u5e94\u00a0\/\u00a0\u65e0\u7f51\n \u5ef6\u540e\u7ea6\u00a030s\u00a0\u518d\u8bd5\uff0c\u4e0d\u5360\u91cd\u8bd5\u6b21\u6570\n onReportFailure(6006,\u00a0\u2026)\u00a0\u81f3\u591a\u4e00\u6b21\uff1b\u6062\u590d\u7f51\u540e\u53ef\u00a0onReportSuccess\n\n\n\n\n9.\u00a0\u7f51\u7edc\u3001\u65e0\u7f51\u5ef6\u540e\u4e0e\u961f\u5217\n9.1\u00a0\u961f\u5217\u4e0e\u7ebf\u7a0b\n\n\n\u91c7\u96c6\u6210\u529f\u4e14\u4e0a\u4f20\u5df2\u914d\u7f6e\u65f6\uff0c\u4efb\u52a1\u5199\u5165\u00a0SQLite\uff0c\u7531\u00a0\u5355\u7ebf\u7a0b\u00a0uploadExecutor\u00a0\u987a\u5e8f\u4e0a\u4f20\u3002\u00a0\n\n\n\u65e5\u914d\u989d\uff083001\/3002\uff09\uff1a\u53ef\u80fd\u00a0onReportSkip\uff0creason\u00a0\u542b\u00a0daily_quota_reset_at\uff08\u89c1\u7f51\u5173\u6587\u6863\uff09\u3002\n\n\n9.2\u00a0\u65e0\u7f51\u00a0\/\u00a0\u4f20\u8f93\u5c42\u5931\u8d25\uff08NETWORK_ERROR\u00a0=\u00a06006\uff09\n\u4e0a\u4f20\u7ebf\u7a0b\u5728\u00a0\u771f\u6b63\u53d1\u8d77\u00a0HTTP\u00a0\u4e4b\u524d\u00a0\u4f1a\u8c03\u7528\u00a0NetworkReachability.hasInternet\uff08\u9700\u00a0ACCESS_NETWORK_STATE\uff0c\u7531\u672c\u6a21\u5757\u00a0manifest\u00a0\u5408\u5e76\u8fdb\u5bbf\u4e3b\uff09\uff1a\n\n\nAndroid\u00a0M\uff08API\u00a023\uff09\u53ca\u4ee5\u4e0a\uff1a\u5f53\u524d\u9ed8\u8ba4\u7f51\u7edc\u987b\u5177\u5907\u00a0NET_CAPABILITY_INTERNET\u00a0\u4e14\u00a0NET_CAPABILITY_VALIDATED\uff08\u7cfb\u7edf\u5df2\u5224\u5b9a\u53ef\u4e0a\u7f51\uff09\uff0c\u5426\u5219\u89c6\u4e3a\u65e0\u7f51\u3002\u00a0\n\n\n\u66f4\u4f4e\u7248\u672c\uff1aNetworkInfo.isConnected()\u00a0\u4e3a\u771f\u624d\u7ee7\u7eed\u3002\n\n\n\u82e5\u9884\u68c0\u5224\u5b9a\u65e0\u7f51\uff0c\u6216\u00a0HttpURLConnection\u00a0\u5728\u6536\u5230\u00a0HTTP\u00a0\u72b6\u6001\u884c\u4e4b\u524d\u5931\u8d25\uff08\u8d85\u65f6\u3001UnknownHost\u3001\u65e0\u8def\u7531\u7b49\uff0c\u4e0a\u4f20\u7ed3\u679c\u8868\u73b0\u4e3a\u00a0httpCode==0\u00a0\u4e14\u00a0gatewayCode==-1\uff09\uff0c\u8fdb\u5165\u00a0\u5ef6\u540e\u8def\u5f84\uff1a\n\n\n\n \u9879\n \u884c\u4e3a\n\n\n\n\n \u91cd\u8bd5\u8ba1\u6570\n \u4e0d\u589e\u52a0\u00a0retry_count\uff08\u4e0d\u8ba1\u5165\u00a0MaterialMonitorConfig.getMaxUploadAttempts()\u00a0\u7684\u300c\u53ef\u91cd\u8bd5\u5931\u8d25\u300d\u9884\u7b97\uff09\n\n\n \u6570\u636e\n \u4fdd\u7559\u00a0DB\u00a0\u884c\u4e0e\u672c\u5730\u00a0JPEG\n\n\n \u5b9a\u65f6\u518d\u8bd5\n \u7ea6\u00a030\u00a0\u79d2\u00a0\u540e\u518d\u6b21\u8c03\u5ea6\u00a0processNextUploadTask\u00a0\u63a2\u6d4b\u961f\u5217\n\n\n onReportFailure\n \u540c\u4e00\u00a0uploadTaskId\u00a0\u5728\u300c\u6301\u7eed\u5904\u4e8e\u5ef6\u540e\u72b6\u6001\u300d\u671f\u95f4\uff0cNETWORK_ERROR\u00a0\u53ea\u56de\u8c03\u4e00\u6b21\uff0c\u907f\u514d\u65e5\u5fd7\/\u57cb\u70b9\u5237\u5c4f\n\n\n ReportCallback\u00a0\u751f\u547d\u5468\u671f\n \u4e0d\u56e0\u8be5\u6b21\u5931\u8d25\u800c\u79fb\u9664\uff1b\u540e\u7eed\u540c\u4e00\u4efb\u52a1\u4e0a\u4f20\u6210\u529f\u65f6\uff0c\u4ecd\u53ef\u6536\u5230\u00a0onReportSuccess\uff08\u4e0e\u300c\u5148\u5931\u8d25\u540e\u6210\u529f\u300d\u4e0d\u77db\u76fe\uff0c\u8be6\u89c1\u00a0ReportCallback\u00a0JavaDoc\uff09\n\n\n\n\u5bbf\u4e3b\u53ef\u5728\u00a0NetworkCallback.onAvailable\u3001\u56de\u5230\u524d\u53f0\u7684\u00a0onResume\u00a0\u7b49\u5904\u8c03\u7528\u00a0MaterialMonitor.get().flushPendingFrames()\uff0c\u7f29\u77ed\u300c\u7b49\u00a030\u00a0\u79d2\u300d\u7684\u7a7a\u7a97\uff08\u4e0e\u5185\u90e8\u5b9a\u65f6\u53e0\u52a0\u65e0\u5bb3\uff09\u3002\n9.3\u00a0flushPendingFrames\uff08\u6458\u8981\uff09\nMaterialMonitor.get().flushPendingFrames();\n\n\u4e3b\u52a8\u5524\u9192\u4e00\u6b21\u961f\u5217\u00a0drain\uff1b\u53ef\u4ece\u4efb\u610f\u7ebf\u7a0b\u8c03\u7528\u3002\u5178\u578b\u573a\u666f\u89c1\u00a0\u00a75.7\u00a0\u8868\u683c\u3002\n\n10.\u00a0\u9690\u79c1\u4e0e\u5408\u89c4\u5efa\u8bae\n\n\n\u53ea\u622a\u53d6\u00a0\u5e7f\u544a\u76f8\u5173\u533a\u57df\u00a0\u7684\u00a0View\uff0c\u907f\u514d\u628a\u4e2a\u4eba\u654f\u611f\u754c\u9762\u622a\u8fdb\u53bb\u3002\u00a0\n\n\n\u8bbe\u5907\u6807\u8bc6\uff08OAID\u3001GAID\u00a0\u7b49\uff09\u8bf7\u9075\u5b88\u5f53\u5730\u6cd5\u5f8b\u4e0e\u5e73\u53f0\u653f\u7b56\u3002\u00a0\n\n\nappKey\u00a0\u4e0d\u5efa\u8bae\u786c\u7f16\u7801\u5728\u516c\u5f00\u7684\u5730\u65b9\u3002\n\n\n\n11.\u00a0\u6392\u9519\u6e05\u5355\n\n\n\n \u73b0\u8c61\n \u53ef\u80fd\u9519\u8bef\u7801\n \u68c0\u67e5\u9879\n\n\n\n\n \u8c03\u7528\u65e0\u6548\u679c\u00a0\/\u00a0warn\u00a0not\u00a0initialized\n \u2014\n \u662f\u5426\u5df2\u00a0MaterialMonitor.init\uff1b\u672a\u00a0init\u00a0\u65f6\u00a0get()\u00a0\u4e3a\u00a0idle\u00a0\u5b9e\u4f8b\n\n\n \u5ef6\u65f6\u540e\u91c7\u96c6\u5931\u8d25\n 6001\n View\u00a0\u662f\u5426\u4ecd\u00a0attached\uff1b\u8c03\u7528\u65f6\u673a\u662f\u5426\u8fc7\u65e9\n\n\n \u63d2\u5c4f\/\u6fc0\u52b1\u5168\u5c4f\u5931\u8d25\n 6002\n collectFrameFromAdPage\u00a0\u662f\u5426\u4f20\u5165\u00a0hostActivity\uff1b\u5ef6\u65f6\u540e\u5e7f\u544a\u9875\u662f\u5426\u4ecd\u53ef\u89c1\n\n\n \u9ed1\u5c4f\u00a0\/\u00a0\u89c6\u9891\u753b\u9762\u4e0d\u5bf9\n 6003\n \u89c6\u9891\u7528\u00a0collectFrameFromAdContainer\uff1b\u589e\u5927\u00a0delayMs\uff08\u00a74.2\uff09\n\n\n \u56fe\u7247\u8fc7\u5927\u65e0\u6cd5\u538b\u7f29\n 6004\n \u964d\u4f4e\u00a0maxLongEdge\uff08540\uff5e1440\uff09\u6216\u00a0maxSizeKb\n\n\n \u5e7f\u544a\u5173\u540e\u4ecd\u60f3\u91c7\u5e27\u5374\u5931\u8d25\n 6009\n \u5c5e\u9884\u671f\uff1b\u672a\u5173\u524d\u5e94\u5b8c\u6210\u91c7\u96c6\uff0c\u6216\u4e0d\u8981\u8c03\u00a0onAdClosed\n\n\n \u4e00\u76f4\u00a0NOT_READY\n 6008\n baseUploadUrl\u3001appId\u3001appKey\u00a0\u662f\u5426\u9f50\u5168\n\n\n NETWORK_ERROR\u00a0\u540e\u4ecd\u00a0pending\n 6006\n \u5ef6\u540e\u4e0a\u4f20\uff08\u00a79.2\uff09\uff1b\u6062\u590d\u7f51\u7edc\u540e\u00a0flushPendingFrames()\n\n\n \u591a\u6b21\u5931\u8d25\u7ec8\u6001\n 6007\u00a0\/\u00a0\u7f51\u5173\u7801\n \u67e5\u00a0message\u00a0\u4e2d\u00a0gateway\u00a0NNNN:\u00a0\u4e0e\u00a0trace_id\uff08\u00a78.4\uff09\n\n\n \u91cd\u590d\u4e0a\u62a5\n \u2014\uff08onReportSkip\uff09\n \u540c\u4e00\u00a0uploadTaskId\u00a0\u53ea\u5165\u961f\u4e00\u6b21\n\n\n \u60f3\u91cd\u65b0\u4e0a\u4f20\u540c\u4e00\u6587\u4ef6\n \u2014\n \u4f7f\u7528\u00a0uploadTaskId\u00a0\u4e3a\u7a7a\u7684\u00a0FrameRecord\u00a0\u8c03\u00a0reportFrameRecord\uff0c\u6216\u91cd\u65b0\u91c7\u96c6\n\n\n \u539f\u751f\u56fe\u7247\u65e0\u672c\u5730\u00a0JPEG\n \u2014\n \u6709\u6548\u00a0URL\u00a0\u8d70\u00a0url-only\uff1b\u89c6\u9891\u7c7b\u7528\u00a0collectFrameFromAdContainer\n\n\n \u63d2\u5c4f\u622a\u5230\u5bbf\u4e3b\u9875\n 6002\u00a0\/\u00a06003\n \u4f20\u5165\u00a0hostActivity\uff1b\u5173\u95ed\u65f6\u8c03\u00a0onAdClosed\n\n\n\n\u5b8c\u6574\u9519\u8bef\u7801\u8868\u89c1\u00a0\u00a78\u3002","is_draft":"0","editor_type":"2","file_path":"","add_time":"1782962762","update_time":"1782963958"},"pure_content":"\u672c\u6587\u6863\u9762\u5411\u63a5\u5165\u5e7f\u544aSDK\u00a0\u7684\u5f00\u53d1\u8005\uff0c\u8bf4\u660e\u5982\u4f55\u5728\u5f00\u5c4f\/\u6a2a\u5e45\/\u539f\u751f\uff08\u6709\u5bb9\u5668\uff09 \u4e0e \u63d2\u5c4f\/\u6fc0\u52b1\u89c6\u9891\uff08\u65e0\u5bb9\u5668\uff09 \u4e24\u79cd\u573a\u666f\u4e0b\uff0c\u5728\u5c55\u793a\u56de\u8c03\u91cc\u5bf9\u5e7f\u544a\u753b\u9762\u505a\u622a\u5e27\uff0c\u7528\u4e8e\u7d20\u6750\u5f52\u6863\u3001\u62bd\u68c0\u6216\u4e0a\u62a5\u3002\u8bf7\u7ed3\u5408\u00a0\u5e7f\u544aSDK\u00a0\u7684\u5c55\u793a\u00a0API\u00a0\u4e0e\u56de\u8c03\uff0c\u4fbf\u4e8e\u76f4\u63a5\u843d\u5730\u5b9e\u73b0\u3002\n\u4e0b\u8f7d\u5730\u5740\uff1ahttp:\/\/info.appsmartsite.com\/Material_monitor\/Android_MaterialMonitor.zip"},{"id":"853996","string_id":"0rPCpO3f","status":"1","parent_id":"853989","slug":"0rPCpO3f","order":"0","name":"\u5e7f\u544a\u7d20\u6750\u63a2\u6d4b-iOS \u63a5\u5165\u8bf4\u660e","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1782963947","add_time":"1782963259","update_time":"1782963958","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"853996","content":"## \u4e00\u3001\u7b80\u4ecb\n\n> - MaterialMonitor \u662f\u4e00\u6b3e\u5e7f\u544a\u7d20\u6750\u76d1\u6d4b SDK\uff0c\u7528\u4e8e\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u91c7\u96c6\u5e7f\u544a\u753b\u9762\u622a\u56fe\uff08\u542b\u89c6\u9891\u5e27\u5408\u6210\uff09+ \u5143\u6570\u636e\uff0c\u5e76\u81ea\u52a8\u4e0a\u4f20\u5230\u7d20\u6750\u5ba1\u8ba1\u670d\u52a1\u7aef\uff0c\u7528\u4e8e\u7d20\u6750\u5408\u89c4\u5ba1\u8ba1\u4e0e\u8d28\u91cf\u76d1\u6d4b\u3002\n> - \u4e0b\u8f7d\u5730\u5740\uff1a[http:\/\/info.appsmartsite.com\/Material_monitor\/iOS_MaterialMonitor.zip](http:\/\/info.appsmartsite.com\/Material_monitor\/iOS_MaterialMonitor.zip)\n\n### \u6838\u5fc3\u80fd\u529b\n\n| \u80fd\u529b | \u8bf4\u660e |\n|---|---|\n| \u622a\u56fe\u91c7\u96c6 | \u652f\u6301\u5f00\u5c4f \/ Banner \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891 \/ \u539f\u751f\u5e7f\u544a |\n| \u89c6\u9891\u5408\u6210\u622a\u56fe | \u81ea\u52a8\u8bc6\u522b `AVPlayerLayer` \u5e76\u5408\u6210\u89c6\u9891\u5e27 + UIKit \u8986\u76d6\u5c42 |\n| \u6301\u4e45\u5316\u961f\u5217 | \u6c99\u76d2\u843d\u76d8 + \u51b7\u542f\u52a8\u6062\u590d + \u91cd\u8bd5 + \u7f51\u7edc\u611f\u77e5 |\n| \u81ea\u52a8\u4e0a\u62a5 | \u5185\u7f6e\u7b7e\u540d\uff08HMAC-MD5\uff09 + multipart \u4e0a\u4f20 + \u9650\u6d41\u91cd\u8bd5\u7b56\u7565 |\n| \u9690\u79c1\u4fdd\u62a4 | \u81ea\u52a8\u906e\u76d6\u5bc6\u7801\u8f93\u5165\u6846 \/ firstResponder\uff0c\u652f\u6301\u81ea\u5b9a\u4e49\u906e\u76d6\u533a\u57df |\n| \u7b56\u7565\u611f\u77e5 | \u652f\u6301\u6309 placementId \/ networkFirmId \/ \u6837\u5f0f\u52a8\u6001\u542f\u505c |\n\n---\n\n## \u4e8c\u3001\u521d\u59cb\u5316\u4e0e\u5173\u95ed\n\n### 2.1 \u521d\u59cb\u5316\uff08\u5fc5\u987b\uff09\n\n\u8c03\u7528\u65f6\u673a\uff1a\u5efa\u8bae\u5728 ATT \u6388\u6743\u56de\u8c03\u4e4b\u540e\u521d\u59cb\u5316\uff08\u786e\u4fdd IDFA \u53ef\u7528\uff09\uff0c\u6574\u4e2a App \u751f\u547d\u5468\u671f\u4ec5\u8c03\u7528\u4e00\u6b21**\u3002\n\n#### Swift\n\n```swift\nimport MaterialMonitorSDK\nimport AppTrackingTransparency\nimport AdSupport\n\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n\n \/\/ \u5efa\u8bae\u653e\u5728 applicationDidBecomeActive \u91cc\u8d70 ATT \u6388\u6743\u6d41\u7a0b\n func applicationDidBecomeActive(_ application: UIApplication) {\n if #available(iOS 14, ) {\n ATTrackingManager.requestTrackingAuthorization { _ in\n self.initMaterialMonitor()\n }\n } else {\n initMaterialMonitor()\n }\n }\n\n private func initMaterialMonitor() {\n let appId = \"your_app_id\"\n let appKey = \"your_app_key\"\n let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString\n let sdkVersion = \"your_host_sdk_version\" \/\/ \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\n\n \/\/ MARK: - MaterialMonitor SDK \u521d\u59cb\u5316\uff08\u5b8c\u6574\u53c2\u6570\uff09\n let config = MaterialMonitorConfig.Builder()\n \/\/ \u2500\u2500 \u4e0a\u4f20\u670d\u52a1\u5730\u5740\uff08\u7559\u7a7a\u5219\u4f7f\u7528 SDK \u5185\u7f6e\u9ed8\u8ba4\u5730\u5740\uff09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n \/\/ \u2500\u2500 \u9274\u6743 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .appId(appId)\n .appKey(appKey)\n \/\/ \u2500\u2500 \u8bbe\u5907\u6807\u8bc6\u7b26 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .idfa(idfa) \/\/ ATT \u6388\u6743\u540e\u4f20\u5165 ATTrackingManager.advertisingIdentifier.uuidString\n .idfv(nil) \/\/ nil \u65f6 SDK \u81ea\u52a8\u4ece UIDevice.current.identifierForVendor \u8bfb\u53d6\n .sdkVersion(sdkVersion) \/\/ \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\uff0c\u5199\u5165 meta device_info.sdk_version\n .caid(nil) \/\/ CAID\uff08\u4e2d\u56fd\u5e7f\u544a ID\uff0c\u53ef\u9009\uff09\n \/\/ \u2500\u2500 \u7f51\u7edc\u8d85\u65f6\uff08ms\uff09 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .connectTimeoutMs(15_000) \/\/ TCP \u8fde\u63a5\u8d85\u65f6\uff0c\u9ed8\u8ba4 15s\uff0c\u6700\u5c0f 3s\n .readTimeoutMs(30_000) \/\/ \u670d\u52a1\u7aef\u54cd\u5e94\u8d85\u65f6\uff0c\u9ed8\u8ba4 30s\uff0c\u6700\u5c0f 3s\n \/\/ \u2500\u2500 \u91cd\u8bd5\u7b56\u7565 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .maxUploadAttempts(3) \/\/ \u9996\u6b21 + \u6700\u591a 2 \u6b21\u91cd\u8bd5\uff0c\u6700\u5c0f 1\n .retryDelayMs([5_000, 15_000]) \/\/ \u5404\u6b21\u91cd\u8bd5\u7b49\u5f85\u65f6\u957f\uff08Swift \u4e13\u5c5e\uff09\n \/\/ \u2500\u2500 \u8c03\u8bd5\uff08\u751f\u4ea7\u73af\u5883\u8bf7\u4fdd\u6301 false\uff09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .debugPerfLogging(false)\n .build()\n\n MaterialMonitor.initialize(config: config)\n }\n}\n```\n\n#### Objective-C\n\n```objc\n#import \n#import \n#import \n\n- (void)applicationDidBecomeActive:(UIApplication )application {\n if (@available(iOS 14, )) {\n [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {\n [self initMaterialMonitor];\n }];\n } else {\n [self initMaterialMonitor];\n }\n}\n\n- (void)initMaterialMonitor {\n NSString appId = @\"your_app_id\";\n NSString appKey = @\"your_app_key\";\n NSString idfa = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];\n NSString sdkVersion = @\"6.5.0\";\n\n MMConfigBuilder builder = [[MMConfigBuilder alloc] init];\n \/\/ \u2500\u2500 \u4e0a\u4f20\u670d\u52a1\u5730\u5740\uff08\u7559\u7a7a\u4f7f\u7528 SDK \u5185\u7f6e\u9ed8\u8ba4\uff09 \u2500\u2500\n [builder baseUploadUrl:@\"https:\/\/your-upload-host.com\"];\n \/\/ \u2500\u2500 \u9274\u6743 \u2500\u2500\n [builder appId:appId];\n [builder appKey:appKey];\n \/\/ \u2500\u2500 \u8bbe\u5907\u6807\u8bc6\u7b26 \u2500\u2500\n [builder idfa:idfa];\n [builder idfv:nil];\n [builder sdkVersion:sdkVersion];\n [builder caid:nil];\n \/\/ \u2500\u2500 \u7f51\u7edc\u8d85\u65f6\uff08ms\uff09 \u2500\u2500\n [builder connectTimeoutMs:15000];\n [builder readTimeoutMs:30000];\n \/\/ \u2500\u2500 \u91cd\u8bd5\u7b56\u7565\uff08ObjC \u4e0d\u652f\u6301\u81ea\u5b9a\u4e49 retryDelayMs\uff0c\u4f7f\u7528\u9ed8\u8ba4\u503c [5000, 15000]\uff09 \u2500\u2500\n [builder maxUploadAttempts:3];\n \/\/ \u2500\u2500 \u8c03\u8bd5\uff08\u751f\u4ea7\u73af\u5883\u8bf7\u4fdd\u6301 NO\uff09 \u2500\u2500\n [builder debugPerfLogging:NO];\n\n MaterialMonitorConfig config = [builder build];\n [MaterialMonitor initializeWithConfig:config];\n}\n```\n\n> \u63d0\u793a 1\uff1a`MaterialMonitor` \u662f\u5355\u4f8b\uff08`MaterialMonitor.shared`\uff09\uff0c\u521d\u59cb\u5316\u540e\u901a\u8fc7 `MaterialMonitor.shared.xxx()` \u8c03\u7528\u6240\u6709\u5b9e\u4f8b\u65b9\u6cd5\u3002\n>\n> \u63d0\u793a 2\uff1a\u6240\u6709\u53c2\u6570\u90fd\u6709\u5408\u7406\u9ed8\u8ba4\u503c\uff0c\u6700\u5c11\u5fc5\u586b `appId` \u548c `appKey` \u5373\u53ef\u5de5\u4f5c\uff1b\u5176\u4ed6\u53c2\u6570\u6309\u9700\u8986\u76d6\u3002\n>\n> \u63d0\u793a 3\uff1aObjC \u4e0d\u652f\u6301 `retryDelayMs(_:)`\uff08Swift \u6570\u7ec4\u6865\u63a5\u9650\u5236\uff09\uff0cObjC \u5de5\u7a0b\u4f7f\u7528\u5185\u7f6e\u9ed8\u8ba4 `[5000, 15000]`\u3002\n\n### 2.2 \u91cd\u65b0\u521d\u59cb\u5316\n\n\u5141\u8bb8\u5728\u8fd0\u884c\u4e2d\u91cd\u590d\u8c03\u7528 `initialize(config:)` \u2014\u2014 SDK \u4f1a\u81ea\u52a8 teardown \u65e7\u8c03\u5ea6\u5668\uff08\u53d6\u6d88\u5b9a\u65f6\u5668\u3001\u4e2d\u65ad\u5728\u9014\u8bf7\u6c42\u3001\u6e05\u7a7a\u56de\u8c03\uff09\uff0c\u518d\u7528\u65b0 config \u91cd\u5efa\u3002\u51b7\u542f\u52a8\u626b\u63cf\u4f1a\u91cd\u505a\uff0c\u78c1\u76d8\u5df2\u6709\u4efb\u52a1\u4fdd\u7559\u3002\n\n### 2.3 \u5173\u95ed SDK\n\n```swift\nMaterialMonitor.shutdown()\n```\n\n```objc\n[MaterialMonitor shutdown];\n```\n\n\u5173\u95ed\u540e\u884c\u4e3a\uff1a\n\n| \u9879 | \u884c\u4e3a |\n|---|---|\n| \u91c7\u96c6 \/ \u4e0a\u62a5\u65b9\u6cd5 | \u7acb\u5373\u8fd4\u56de `MMErrorCodeUninitialized` |\n| \u5728\u9014\u4e0a\u4f20\u8bf7\u6c42 | \u786c\u53d6\u6d88\uff08URLSession `invalidateAndCancel`\uff09 |\n| \u91cd\u8bd5\u5b9a\u65f6\u5668\u3001\u7f51\u7edc\u76d1\u542c | \u7acb\u5373\u91ca\u653e |\n| \u4e1a\u52a1\u56de\u8c03\u6ce8\u518c\u8868 | \u6e05\u7a7a\uff08\u5df2\u53d1\u51fa\u56de\u8c03\u6b63\u5e38\u6d3e\u53d1\uff0c\u540e\u7eed\u56de\u8c03\u9759\u9ed8\u4e22\u5f03\uff09 |\n| \u78c1\u76d8\u5df2\u843d\u76d8\u8bb0\u5f55 | \u4fdd\u7559\uff0c\u4e0b\u6b21 `initialize` \u51b7\u542f\u52a8\u626b\u63cf\u65f6\u7ee7\u7eed\u4e0a\u62a5 |\n| Config | \u6e05\u7a7a |\n\n\u5e42\u7b49:\u91cd\u590d\u8c03\u7528 `shutdown()` \u5b89\u5168\u3002\n\u53ef\u91cd\u542f\uff1a`shutdown` \u540e\u518d\u6b21 `initialize` \u53ef\u6062\u590d\u5168\u90e8\u529f\u80fd\u3002\n\n---\n\n## \u4e09\u3001\u914d\u7f6e\u9879 `MaterialMonitorConfig`\n\n\u901a\u8fc7 Builder \u6a21\u5f0f\u6784\u9020\u3002\u6240\u6709\u914d\u7f6e\u9879\u53ca\u9ed8\u8ba4\u503c\u5982\u4e0b\uff1a\n\n| \u5b57\u6bb5 | \u7c7b\u578b | \u9ed8\u8ba4\u503c | \u8bf4\u660e |\n|---|---|---|---|\n| `baseUploadUrl` | String | \u5185\u7f6e\u9ed8\u8ba4\u5730\u5740 | \u4e0a\u4f20\u6839\u57df\u540d\uff08\u5982 `\"https:\/\/api.example.com\"`\uff09\uff0cSDK \u81ea\u52a8\u62fc\u63a5 `\/v1\/creative\/upload`\u3002\u7559\u7a7a\u4f7f\u7528\u5185\u7f6e\u9ed8\u8ba4\u3002 |\n| `appId` | String | `\"\"` | \u5e94\u7528 ID\uff0c\u5199\u5165 multipart \u5b57\u6bb5 `app_id` |\n| `appKey` | String | `\"\"` | HMAC-MD5 \u7b7e\u540d\u5bc6\u94a5\u3002\u4e25\u7981\u6253\u5370 \/ \u7f13\u5b58 \/ \u4e0a\u4f20\u660e\u6587 |\n| `idfa` | String? | nil | ATT \u6388\u6743\u540e\u7684 IDFA\u3002SDK \u76f4\u63a5\u900f\u4f20\uff0c\u4e0d\u8fc7\u6ee4\u5168 0 \u503c |\n| `idfv` | String? | nil | IDFV\u3002nil \u65f6 SDK \u81ea\u52a8\u4ece `UIDevice.current.identifierForVendor` \u8bfb\u53d6 |\n| `sdkVersion` | String? | nil | \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\uff0c\u5199\u5165 meta `device_info.sdk_version` |\n| `caid` | String? | nil | CAID\uff08\u4e2d\u56fd\u5e7f\u544a ID\uff09 |\n| `connectTimeoutMs` | Int | 15000 | TCP \u8fde\u63a5\u8d85\u65f6\uff08ms\uff09\uff0c\u6700\u5c0f\u503c 3000 |\n| `readTimeoutMs` | Int | 30000 | \u670d\u52a1\u5668\u54cd\u5e94\u8d85\u65f6\uff08ms\uff09\uff0c\u6700\u5c0f\u503c 3000 |\n| `maxUploadAttempts` | Int | 3 | \u6700\u5927\u4e0a\u4f20\u5c1d\u8bd5\u6b21\u6570\uff08\u9996\u53d1 + \u91cd\u8bd5\uff09\uff0c\u6700\u5c0f\u503c 1 |\n| `retryDelayMs` | [Int] | `[5000, 15000]` | \u5404\u6b21\u91cd\u8bd5\u7b49\u5f85\u65f6\u957f\uff08ms\uff09\u3002Swift \u4e13\u5c5e\uff0cObjC \u4f7f\u7528\u9ed8\u8ba4\u503c |\n| `maxCacheSizeMb` | Int | 100 | \u6c99\u76d2 `material_monitor\/` \u603b\u5bb9\u91cf\u4e0a\u9650\uff08MB\uff09\uff0c\u6700\u5c0f\u503c 10 |\n| `debugPerfLogging` | Bool | false | \u542f\u7528\u8be6\u7ec6 Debug \u65e5\u5fd7\u3002\u751f\u4ea7\u73af\u5883\u52a1\u5fc5\u5173\u95ed |\n\n### \u5b8c\u6574\u6784\u9020\u793a\u4f8b\uff08Swift\uff09\n\n```swift\nlet config = MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n .appId(appId)\n .appKey(appKey)\n .idfa(idfa) \/\/ ATT \u6388\u6743\u540e\u4f20\u5165\n .idfv(nil) \/\/ nil \u65f6 SDK \u81ea\u52a8\u8bfb\u53d6\n .sdkVersion(sdkVersion)\n .connectTimeoutMs(15_000)\n .readTimeoutMs(30_000)\n .maxUploadAttempts(3)\n .retryDelayMs([5_000, 15_000])\n .debugPerfLogging(false)\n .build()\n```\n\n---\n\n## \u56db\u3001\u91c7\u96c6\u63a5\u53e3\n\nSDK \u63d0\u4f9b\u4e24\u79cd\u91c7\u96c6\u63a5\u53e3\uff0c\u6309\u5e7f\u544a\u662f\u5426\u6709\u53ef\u8bbf\u95ee\u7684\u5bb9\u5668\u89c6\u56fe\u9009\u62e9\uff1a\n\n| \u5e7f\u544a\u5f62\u6001 | \u9002\u7528\u7c7b\u578b | \u63a8\u8350\u63a5\u53e3 |\n|---|---|---|\n| \u6709\u5bb9\u5668 | Banner \/ \u539f\u751f\u5e7f\u544a | `collectFrameFromAdContainer` |\n| \u65e0\u5bb9\u5668 | \u5f00\u5c4f \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891 | `collectFrameFromAdPage` |\n\n> \u6240\u6709\u91c7\u96c6\u65b9\u6cd5\u5fc5\u987b\u5728\u4e3b\u7ebf\u7a0b\u8c03\u7528\u3002\u622a\u56fe\u91c7\u96c6\u4e0e\u4e0a\u62a5\u56de\u8c03\u5747\u5728\u4e3b\u7ebf\u7a0b\u6d3e\u53d1\u3002\n\n### 4.1 \u6709\u5bb9\u5668\u5e7f\u544a\uff08Banner \/ \u539f\u751f\u5e7f\u544a\uff09\n\n```swift\npublic func collectFrameFromAdContainer(\n _ view: UIView,\n adInfo: MMAdInfo,\n timing: AdTimingInput,\n options: FrameOptions,\n callback: FrameCallback\n)\n```\n\n\u53c2\u6570\uff1a\n\n| \u53c2\u6570 | \u7c7b\u578b | \u8bf4\u660e |\n|---|---|---|\n| `view` | UIView | \u5e7f\u544a\u5bb9\u5668\u89c6\u56fe |\n| `adInfo` | MMAdInfo | \u5e7f\u544a\u4fe1\u606f\uff08\u89c1 \u00a77.4\uff09 |\n| `timing` | AdTimingInput | \u5e7f\u544a\u65f6\u95f4\u6233\uff08\u89c1 \u00a77.1\uff09 |\n| `options` | FrameOptions | \u622a\u56fe\u9009\u9879\uff08\u89c1 \u00a77.2\uff09 |\n| `callback` | FrameCallback | \u91c7\u96c6 + \u81ea\u52a8\u4e0a\u62a5\u56de\u8c03\uff08\u5f31\u5f15\u7528\uff0c\u89c1 \u00a76\uff09 |\n\nSwift \u793a\u4f8b\uff08Banner\uff09\uff1a\n\n```swift\nfunc onBannerAdShow(_ bannerView: UIView, extra: [String: Any]) {\n MaterialMonitor.shared.collectFrameFromAdContainer(\n bannerView,\n adInfo: buildMMAdInfo(extra),\n timing: buildTiming(extra),\n options: FrameOptions(delayMs: 200), \/\/ Banner \u5ef6\u8fdf\u53ef\u8f83\u77ed\n callback: self\n )\n}\n```\n\n### 4.2 \u65e0\u5bb9\u5668\u5e7f\u544a\uff08\u5f00\u5c4f \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891\uff09\n\n```swift\npublic func collectFrameFromAdPage(\n adInfo: MMAdInfo,\n timing: AdTimingInput,\n options: FrameOptions,\n callback: FrameCallback\n)\n```\n\nSDK \u4f1a\u81ea\u52a8\u5b9a\u4f4d\u6700\u9876\u5c42 `presentedViewController` \u7684 view\uff0c\u82e5\u4e0d\u5b58\u5728\u5219\u622a `keyWindow`\u3002\n\nSwift \u793a\u4f8b\uff08\u5f00\u5c4f\uff09\uff1a\n\n```swift\nfunc splashAdDidShow() {\n MaterialMonitor.shared.collectFrameFromAdPage(\n adInfo: adInfo,\n timing: timing,\n options: FrameOptions(delayMs: 3000), \/\/ \u5f00\u5c4f\u89c6\u9891\u8f83\u957f\uff0c\u7ed9\u5145\u8db3\u6e32\u67d3\u65f6\u95f4 \u6beb\u79d2\n callback: self\n )\n}\n```\n\n---\n\n## \u4e94\u3001\u624b\u52a8\u4e0a\u62a5\u4e0e\u961f\u5217\u7ba1\u7406\n\n### 5.1 \u624b\u52a8\u5165\u961f\u4e0a\u62a5\n\n\u628a\u5df2\u6709\u7684 `FrameRecord` \u91cd\u65b0\u5165\u961f\uff08\u573a\u666f\uff1a\u4e1a\u52a1\u4fa7\u5ef6\u540e\u4e0a\u62a5\u3001\u8de8\u8fdb\u7a0b\u6062\u590d\uff09\u3002\n\n```swift\npublic func reportFrameRecord(\n _ record: FrameRecord,\n adInfo: MMAdInfo,\n callback: ReportCallback?\n)\n```\n\n\u8bf4\u660e\uff1a\n\n- `record` \u5fc5\u987b\u662f\u4e4b\u524d\u901a\u8fc7 `collectFrame` \u62ff\u5230\u7684\uff08\u542b\u5408\u6cd5 `localFilePath`\uff09\n- \u89e6\u53d1 `show_id` \u548c `upload_task_id` \u53cc\u91cd\u53bb\u91cd\n- callback \u53ef\u9009\uff0c\u4ec5\u5173\u5fc3\u4e0a\u62a5\u7ed3\u679c\n\n### 5.2 \u7acb\u5373\u89e6\u53d1\u5f85\u4e0a\u4f20\u4efb\u52a1\n\n```swift\nMaterialMonitor.shared.flushPendingUploads()\n```\n\n\u901a\u5e38\u65e0\u9700\u624b\u52a8\u8c03\u7528 \u2014\u2014 SDK \u5728\u91c7\u96c6\u6210\u529f \/ \u7f51\u7edc\u6062\u590d \/ \u91cd\u8bd5\u5230\u671f\u65f6\u81ea\u52a8\u89e6\u53d1\u3002\n\n### 5.3 \u67e5\u8be2\u8bb0\u5f55\n\n```swift\n\/\/ Swift\nlet records = MaterialMonitor.shared.getRecords(style: .banner)\n\n\/\/ ObjC\uff08\u6309 adType \u6574\u6570\uff09\nNSArray records = [[MaterialMonitor shared] getRecordsForAdType:2];\n```\n\n\u8fd4\u56de\u975e dead \u72b6\u6001\uff08pending \/ uploading \/ retryWaiting\uff09\u7684\u6240\u6709\u8bb0\u5f55\u3002\n\n### 5.4 \u5220\u9664\u8bb0\u5f55\n\n```swift\nMaterialMonitor.shared.deleteRecord(record)\n```\n\n\u884c\u4e3a\u5206\u652f\uff1a\n\n| \u5f53\u524d\u72b6\u6001 | \u884c\u4e3a |\n|---|---|\n| pending \/ retryWaiting | \u7acb\u5373\u5220\u9664\u6587\u4ef6\u5bf9\uff0c\u4e0d\u89e6\u53d1\u56de\u8c03 |\n| uploading | \u6807\u8bb0\u4e3a dead\uff0cHTTP \u5b8c\u6210\u540e\u9759\u9ed8\u5220\u9664 |\n| dead | \u7acb\u5373\u5220\u9664\u6587\u4ef6\u5bf9 |\n\n### 5.5 \u83b7\u53d6\u5f53\u524d\u914d\u7f6e\n\n```swift\nlet config = MaterialMonitor.shared.getConfig()\n```\n\n\u672a\u521d\u59cb\u5316\u6216\u5df2 shutdown \u65f6\u8fd4\u56de nil\u3002\n\n---\n\n## \u516d\u3001\u56de\u8c03\u534f\u8bae\n\n### 6.1 FrameCallback\uff08\u91c7\u96c6 + \u4e0a\u62a5\uff09\n\n```swift\n@objc public protocol FrameCallback: AnyObject {\n func onCollectSuccess(_ record: FrameRecord)\n func onCollectFailure(errorCode: Int, errorName: String, message: String)\n func onReportSuccess(_ record: FrameRecord)\n func onReportSkip(_ record: FrameRecord, reason: String)\n func onReportFailure(errorCode: Int, errorName: String, message: String, record: FrameRecord?)\n}\n```\n\n| \u56de\u8c03 | \u89e6\u53d1\u65f6\u673a |\n|---|---|\n| `onCollectSuccess` | \u622a\u56fe\u6210\u529f + \u843d\u76d8 + \u5165\u961f |\n| `onCollectFailure` | \u622a\u56fe\u6216\u5165\u961f\u5931\u8d25\uff08\u4e0d\u4f1a\u518d\u89e6\u53d1\u540e\u7eed\u4e0a\u62a5\u56de\u8c03\uff09 |\n| `onReportSuccess` | \u670d\u52a1\u7aef\u8fd4\u56de code=0 |\n| `onReportSkip` | `show_id` \u5df2\u5b58\u5728\uff08duplicated_show_id\uff09 |\n| `onReportFailure` | \u91cd\u8bd5\u8017\u5c3d \/ \u9274\u6743\u5931\u8d25 \/ \u53c2\u6570\u9519\u8bef \/ \u914d\u989d\u8017\u5c3d\u7b49\u7ec8\u6001 |\n\n### 6.2 ReportCallback\uff08\u4ec5\u4e0a\u62a5\uff09\n\n`reportFrameRecord` \u4f7f\u7528\uff0c\u7b7e\u540d\u540c `FrameCallback` \u7684\u4e0a\u62a5\u90e8\u5206\u3002\n\n### 6.3 \u5173\u952e\u7279\u6027 \u26a0\ufe0f\n\n- \u6240\u6709\u56de\u8c03\u5728\u4e3b\u7ebf\u7a0b\u6d3e\u53d1\uff0c\u53ef\u76f4\u63a5\u8bbf\u95ee UI\n- \u56de\u8c03\u91c7\u7528\u5f31\u5f15\u7528\uff08`weak`\uff09\uff0cViewController \u91ca\u653e\u540e\u56de\u8c03\u9759\u9ed8\u4e22\u5f03\uff0c\u4e0d\u4f1a\u6cc4\u6f0f\n- \u91c7\u96c6\u6d41\u7a0b\u8fdb\u884c\u4e2d\uff08delay + \u622a\u56fe + \u538b\u7f29 + \u843d\u76d8\uff09callback \u88ab\u5f3a\u5f15\u7528\u6301\u6709\uff0cVC \u5728\u6b64\u671f\u95f4\u4e0d\u4f1a\u88ab\u91ca\u653e\uff08\u6700\u957f ~3 \u79d2 + \u5904\u7406\u65f6\u95f4\uff09\uff0c\u9700\u6ce8\u610f\n\n---\n\n## \u4e03\u3001\u6570\u636e\u6a21\u578b\n\n### 7.1 `AdTimingInput`\n\n```swift\npublic init(requestTimeMs: Int64, fillTimeMs: Int64, showTimeMs: Int64)\n```\n\n\u5e7f\u544a\u5404\u9636\u6bb5\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\u3002\u4fbf\u5229\u6784\u9020\uff1a\n\n```swift\nlet timing = AdTimingInput.sameWallClockMs(Int64(Date().timeIntervalSince1970 1000))\n```\n\n### 7.2 `FrameOptions`\n\n```swift\npublic init(\n delayMs: Int = 500,\n maxSizeKb: Int = 300,\n maxLongEdge: Int = 1080,\n keepQualityFirst: Bool = true,\n excludeViews: [UIView] = []\n)\n```\n\n| \u5b57\u6bb5 | \u9ed8\u8ba4 | \u8bf4\u660e |\n|---|---|---|\n| `delayMs` | 500 | \u7b49\u5f85\u5e7f\u544a\u7d20\u6750\u52a0\u8f7d\u5b8c\u6210\u7684\u5ef6\u8fdf\uff08ms\uff09\u3002\u89c6\u9891\u5e7f\u544a\u5efa\u8bae 2000+\uff0cBanner\u3001\u539f\u751f 200~300 \u5373\u53ef |\n| `maxSizeKb` | 300 | JPEG \u538b\u7f29\u76ee\u6807\u6700\u5927\u4f53\u79ef\uff08KB\uff09 |\n| `maxLongEdge` | 1080 | \u843d\u76d8 JPEG \u6700\u957f\u8fb9\u50cf\u7d20\u4e0a\u9650 |\n| `keepQualityFirst` | true | \u662f\u5426\u4f18\u5148\u4fdd\u8bc1\u56fe\u50cf\u8d28\u91cf\uff08\u4ece 0.7 \u8d77\u964d\u8d28\u91cf\uff09 |\n| `excludeViews` | [] | \u9700\u8981\u906e\u76d6\u7684\u5b50\u89c6\u56fe\uff08\u9690\u79c1\u533a\u57df\uff0c\u5982\u81ea\u5b9a\u4e49\u5bc6\u7801\u6846\uff09 |\n\n### 7.3 `FrameRecord`\n\n\u4ee3\u8868\u4e00\u6b21\u91c7\u96c6\u7ed3\u679c\u3002\u4e1a\u52a1\u65b9\u4e00\u822c\u53ea\u8bfb\u4f7f\u7528\u3002\n\n| \u5b57\u6bb5 | \u7c7b\u578b | \u8bf4\u660e |\n|---|---|---|\n| `showId` | String | \u5e7f\u544a\u5c55\u793a ID\uff08\u670d\u52a1\u7aef\u5e42\u7b49\u53bb\u91cd\u952e\uff09 |\n| `uploadTaskId` | String | SDK \u5185\u90e8 UUID |\n| `placementId` | String | \u5e7f\u544a\u4f4d ID |\n| `style` | MaterialStyle | \u5e7f\u544a\u6837\u5f0f\uff08Swift\uff09 |\n| `adType` | Int | \u5e7f\u544a\u7c7b\u578b\u6574\u6570\uff08ObjC \u53cb\u597d\uff09 |\n| `requestTimeMs` \/ `fillTimeMs` \/ `showTimeMs` | Int64 | \u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09 |\n| `imageUrl` | String? | \u539f\u751f\u7d20\u6750 URL\uff08\u4ec5 native \u573a\u666f\uff09 |\n| `localFilePath` | String | \u6c99\u76d2\u7edd\u5bf9\u8def\u5f84 |\n| `imageHash` | String | pHash\uff0816 \u5b57\u7b26\u5c0f\u5199 hex\uff09 |\n| `createdAt` | Int64 | \u91c7\u96c6\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09 |\n\n### 7.4 `MMAdInfo`\n\n\u5e7f\u544a\u4fe1\u606f\uff0c\u4e1a\u52a1\u65b9\u5728 onAdShow \u56de\u8c03\u4e2d\u6784\u9020\uff1a\n\n| \u5b57\u6bb5 | \u7c7b\u578b | \u5fc5\u586b | \u8bf4\u660e |\n|---|---|---|---|\n| `requestId` | String | \u2705 | \u8bf7\u6c42 ID |\n| `showId` | String | \u2705 | \u5e7f\u544a\u5c55\u793a\u552f\u4e00 ID\uff08\u5e42\u7b49\u53bb\u91cd\u952e\uff09 |\n| `placementId` | String | \u2705 | \u5e7f\u544a\u4f4d ID |\n| `adSourceId` | String | \u2705 | \u5e7f\u544a\u6e90 ID |\n| `adNetworkFirmId` | Int | \u2705 | \u5e7f\u544a\u7f51\u7edc ID |\n| `adType` | Int | \u2705 | \u5e7f\u544a\u7c7b\u578b\u6574\u6570\uff1a0=Native \/ 1=RewardedVideo \/ 2=Banner \/ 3=Interstitial \/ 4=Splash |\n| `requestTimestamp` | Int64 | \u2705 | \u8bf7\u6c42\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09 |\n| `fillTimestamp` | Int64 | \u2705 | \u586b\u5145\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09 |\n| `showTimestamp` | Int64 | \u2705 | \u5c55\u793a\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09 |\n| `creativeId` | String? | \u9009 | \u521b\u610f ID\uff08\u90e8\u5206\u5e7f\u544a\u7f51\u7edc\u4e0d\u8fd4\u56de\uff09 |\n| `ecpm` | NSNumber? | \u9009 | eCPM |\n| `sceneId` | String? | \u9009 | \u573a\u666f ID |\n\n### 7.5 `MaterialStyle`\n\n| \u679a\u4e3e\u503c | adType | rawValue |\n|---|---|---|\n| `.native` | 0 | \"native\" |\n| `.rewarded` | 1 | \"rewarded\" |\n| `.banner` | 2 | \"banner\" |\n| `.interstitial` | 3 | \"interstitial\" |\n| `.splash` | 4 | \"splash\" |\n\n---\n\n## \u516b\u3001\u9519\u8bef\u7801\n\n`MMErrorCode` \u679a\u4e3e\uff08ObjC \u7528 `MMErrorCodeXxx` \u524d\u7f00\uff09\uff1a\n\n### \u91c7\u96c6\u9519\u8bef\uff081xxx\uff09\n\n| \u6570\u5b57\u503c | errorName | \u542b\u4e49 | \u662f\u5426\u53ef\u91cd\u8bd5 |\n|---|---|---|---|\n| 1001 | `VIEW_INVALID` | View \u4e3a nil \u6216\u672a attached \u5230 window | \u274c |\n| 1002 | `SCENE_INVALID` | keyWindow \u627e\u4e0d\u5230\u6216\u9876\u5c42 VC \u5df2 dismiss | \u274c |\n| 1003 | `COLLECT_FAILED` | \u622a\u56fe\u5931\u8d25\uff08\u5982 view \u5df2\u91ca\u653e\uff09 | \u274c |\n| 1004 | `COMPRESS_FAILED` | JPEG \u538b\u7f29\u5931\u8d25 | \u274c |\n\n### \u4e0a\u62a5\u9519\u8bef\uff082xxx\uff09\n\n| \u6570\u5b57\u503c | errorName | \u542b\u4e49 | \u662f\u5426\u53ef\u91cd\u8bd5 |\n|---|---|---|---|\n| 2001 | `PARAMS_INVALID` | \u5fc5\u586b\u53c2\u6570\u7f3a\u5931\u6216\u975e\u6cd5 | \u274c |\n| 2002 | `NETWORK_ERROR` | \u7f51\u7edc\u8bf7\u6c42\u5931\u8d25 \/ \u8d85\u65f6 | \u2705 |\n| 2003 | `AUTH_FAILED` | \u9274\u6743\u5931\u8d25\uff08\u68c0\u67e5 appId \/ appKey\uff09 | \u274c |\n| 2004 | `RETRY_EXHAUSTED` | \u91cd\u8bd5\u6b21\u6570\u8017\u5c3d | \u274c |\n| 2005 | `UNINITIALIZED` | SDK \u672a\u521d\u59cb\u5316\u6216\u5df2 shutdown | \u274c |\n| 2006 | `NOT_READY` | \u4e0a\u4f20\u914d\u7f6e\u4e0d\u5168\uff08appId \/ appKey \u7f3a\u5931\uff09 | \u274c |\n| 2007 | `STRATEGY_DISABLED` | \u5f53\u524d\u5e7f\u544a\u4f4d\u88ab\u7b56\u7565\u5173\u95ed | \u274c |\n\n---\n\n## \u4e5d\u3001\u5e38\u89c1\u95ee\u9898\u3001\u6ce8\u610f\u4e8b\u9879\u4e0e\u63a8\u8350\u914d\u7f6e\n\n### Q1\uff1a\u5fc5\u987b\u5728\u4e3b\u7ebf\u7a0b\u8c03\u7528\u91c7\u96c6\u5417\uff1f\n\n\u662f\u3002SDK \u5185\u90e8 `assert(Thread.isMainThread)`\uff0c\u975e\u4e3b\u7ebf\u7a0b\u8c03\u7528\u4f1a\u89e6\u53d1 assert\uff08DEBUG \u5305\u5d29\u6e83\uff0cRelease \u5305\u884c\u4e3a\u672a\u5b9a\u4e49\uff09\u3002\n\n### Q2\uff1a\u91c7\u96c6\u5ef6\u8fdf\uff08`delayMs`\uff09\u8be5\u600e\u4e48\u8bbe\uff1f\n\n| \u5e7f\u544a\u7c7b\u578b | \u63a8\u8350\u5ef6\u8fdf |\n|---|---|\n| Banner | 200ms |\n| \u63d2\u5c4f | 500ms |\n| \u6fc0\u52b1\u89c6\u9891 | 1000ms |\n| \u5f00\u5c4f | 2000~3000ms\uff08\u89c6\u9891\u5f00\u5c4f\u7ed9\u8db3\u6e32\u67d3\u65f6\u95f4\uff09 |\n| Native | 200~500ms\uff08\u4e1a\u52a1\u65b9\u6e32\u67d3\u8f83\u5feb\uff09 |\n\n### Q3\uff1a\u56de\u8c03\u91cc `record.localFilePath` \u4f55\u65f6\u53ef\u7528\uff1f\n\n`onCollectSuccess` \u4e4b\u540e sandbox \u6587\u4ef6\u5df2\u5b58\u5728\uff1b`onReportSuccess` \/ `onReportFailure` \u4e4b\u540e\u6587\u4ef6\u53ef\u80fd\u5df2\u88ab\u6e05\u7406\uff0c\u4e0d\u8981\u5728\u4e0a\u62a5\u56de\u8c03\u91cc\u8bfb localFilePath\u3002\n\n### Q4\uff1a\u5185\u5b58\u5360\u7528\u4e0e\u78c1\u76d8\u7a7a\u95f4\uff1f\n\n- \u5185\u5b58\uff1a\u6bcf\u6b21\u91c7\u96c6\u5cf0\u503c\u7ea6 = \u622a\u56fe\u539f\u56fe\u4f53\u79ef\uff084\u00d7\u5bbd\u00d7\u9ad8 \u5b57\u8282\uff0c1080p \u7ea6 8MB\uff09+ JPEG \u4e34\u65f6 buffer\u3002\u538b\u7f29\u5b8c\u6210\u540e\u91ca\u653e\n- \u78c1\u76d8\uff1a\u9ed8\u8ba4\u4e0a\u9650 100MB\uff08`maxCacheSizeMb`\uff09\uff0c\u8d85\u51fa\u540e\u51b7\u542f\u52a8\u626b\u63cf\u4f1a\u6309 createdAt \u6392\u5e8f\u5220\u9664\u6700\u8001\u7684 dead \u8bb0\u5f55\n\n### Q5\uff1a\u89c6\u9891\u5e7f\u544a\u622a\u56fe\u662f\u9ed1\u5c4f \/ \u89c6\u9891\u753b\u9762\u7f3a\u5931\uff1f\n\niOS \u7cfb\u7edf\u7ea7\u9650\u5236\uff1a\n\n- \u2705 AVPlayerLayer \u6e32\u67d3\u7684\u89c6\u9891 \u2014\u2014 SDK \u5df2\u5b9e\u73b0\u5408\u6210\n- \u274c AVSampleBufferDisplayLayer \u2014\u2014 \u65e0\u6cd5\u62bd\u5e27\n- \u274c CAMetalLayer \/ CAEAGLLayer \u2014\u2014 \u65e0\u6cd5\u62bd\u5e27\n- \u274c DRM \u4fdd\u62a4\u5185\u5bb9 \u2014\u2014 \u7cfb\u7edf\u7981\u6b62\u62bd\u5e27\n\n\u5bf9\u4e8e\u540e\u4e09\u79cd\u60c5\u51b5\uff0ciOS \u7cfb\u7edf\u7ea7\u522b\u65e0\u6cd5\u4ece\u5e94\u7528\u8fdb\u7a0b\u5185\u62bd\u5e27\u3002\u82e5\u9700\u89c6\u9891\u7d20\u6750\u76d1\u6d4b\uff0c\u5efa\u8bae\u7531\u670d\u52a1\u7aef\u901a\u8fc7\u5e7f\u544a\u7f51\u7edc\u4e0b\u53d1\u7684\u7d20\u6750 URL \u76f4\u63a5\u62c9\u53d6\u5206\u6790\u3002\n\n### Q6\uff1adebugPerfLogging \u8be5\u5f00\u542f\u5417\uff1f\n\n\u4ec5\u5728\u8054\u8c03\u671f\u5f00\u542f\u3002\u5f00\u542f\u540e\u4f1a\u901a\u8fc7 `print` \u8f93\u51fa\u5927\u91cf Debug \u65e5\u5fd7\uff1a\n\n- \u6027\u80fd\u635f\u8017\uff1a\u6bcf\u6b21\u622a\u56fe \/ \u4e0a\u4f20\u589e\u52a0\u7ea6 5ms\n- \u9690\u79c1\u98ce\u9669\uff1a\u65e5\u5fd7\u4e2d\u542b `app_id` \/ `sign` \/ meta JSON \u7b49\u5b57\u6bb5\n- \u751f\u4ea7\u73af\u5883\u5fc5\u987b\u5173\u95ed\n\n### Q7\uff1aAPP \u8fdb\u5165\u540e\u53f0\u540e\u8fd8\u4f1a\u7ee7\u7eed\u4e0a\u4f20\u5417\uff1f\n\n\u4f1a\uff0c\u76f4\u5230\u7cfb\u7edf\u6302\u8d77 App\u3002SDK \u4f7f\u7528\u666e\u901a `URLSession`\uff0c\u4e0d\u652f\u6301\u540e\u53f0\u4f20\u8f93\u3002\u82e5 App \u88ab\u6740\u6b7b\uff0c\u672a\u4e0a\u4f20\u7684\u4efb\u52a1\u4f1a\u5728\u4e0b\u6b21\u51b7\u542f\u52a8\u65f6\u6062\u590d\uff08pending \u72b6\u6001\uff09\u3002\n\n### Q8\uff1a\u5982\u4f55\u5bf9\u63a5 ObjC \u5de5\u7a0b\uff1f\n\nSDK \u5168\u9762 `@objc` \u6807\u6ce8\u3002\u9700\u8981\uff1a\n\n1. \u5728 `Bridging-Header.h` \u4e2d\u5bfc\u5165\uff1a`#import `\n2. ObjC Builder \u7c7b\u540d\uff1a`MMConfigBuilder`\n3. \u5b9e\u73b0\u534f\u8bae\uff1a`@interface MyVC : UIViewController `\n\n---\n\n## \u9644\u5f55 A\uff1a\u5b8c\u6574\u63a5\u5165\u793a\u4f8b\n\n### A.1 AppDelegate \u521d\u59cb\u5316\n\n```swift\nimport MaterialMonitorSDK\nimport AppTrackingTransparency\nimport AdSupport\n\n@main\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n\n func application(_ application: UIApplication,\n didFinishLaunchingWithOptions launchOptions: [...]?) -> Bool {\n \/\/ ATT \u6388\u6743\u540e\u518d\u521d\u59cb\u5316\uff08\u63a8\u8350\uff09\n if #available(iOS 14, ) {\n ATTrackingManager.requestTrackingAuthorization { status in\n DispatchQueue.main.async {\n self.setupMaterialMonitor()\n }\n }\n } else {\n setupMaterialMonitor()\n }\n return true\n }\n\n private func setupMaterialMonitor() {\n let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString\n\n let config = MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n .appId(\"your_app_id\")\n .appKey(\"your_app_key\")\n .idfa(idfa)\n .sdkVersion(\"6.5.0\")\n .debugPerfLogging(false)\n .build()\n\n MaterialMonitor.initialize(config: config)\n }\n}\n```\n\n### A.2 Banner \u63a5\u5165\n\n```swift\nextension MyViewController: FrameCallback {\n\n func onBannerAdShow(_ bannerView: UIView, extra: [String: Any]) {\n let adInfo = buildMMAdInfo(from: extra)\n\n MaterialMonitor.shared.collectFrameFromAdContainer(\n bannerView,\n adInfo: adInfo,\n timing: adInfo.timingInput,\n options: FrameOptions(delayMs: 200),\n callback: self\n )\n }\n\n \/\/ MARK: FrameCallback\n func onCollectSuccess(_ record: FrameRecord) {\n print(\"\u2705 \u91c7\u96c6\u6210\u529f taskId=\\(record.uploadTaskId)\")\n }\n func onCollectFailure(errorCode: Int, errorName: String, message: String) {\n print(\"\u274c \u91c7\u96c6\u5931\u8d25 [\\(errorName)] \\(message)\")\n }\n func onReportSuccess(_ record: FrameRecord) {\n print(\"\u2705 \u4e0a\u62a5\u6210\u529f showId=\\(record.showId)\")\n }\n func onReportSkip(_ record: FrameRecord, reason: String) {\n print(\"\u23ed \u4e0a\u62a5\u8df3\u8fc7\uff1a\\(reason)\")\n }\n func onReportFailure(errorCode: Int, errorName: String,\n message: String, record: FrameRecord?) {\n print(\"\u274c \u4e0a\u62a5\u5931\u8d25 [\\(errorName)] \\(message)\")\n }\n}\n```\n\n### A.3 ObjC Banner \u63a5\u5165\n\n```objc\n#import \n\n@interface MyViewController () \n@end\n\n@implementation MyViewController\n\n- (void)onBannerAdShow:(UIView )bannerView extra:(NSDictionary )extra {\n MMAdInfo adInfo = [self buildMMAdInfoFromExtra:extra];\n AdTimingInput timing = [[AdTimingInput alloc]\n initWithRequestTimeMs:adInfo.requestTimestamp\n fillTimeMs:adInfo.fillTimestamp\n showTimeMs:adInfo.showTimestamp];\n FrameOptions options = [[FrameOptions alloc] init];\n\n [[MaterialMonitor shared] collectFrameFromAdContainer:bannerView\n adInfo:adInfo\n timing:timing\n options:options\n callback:self];\n}\n\n#pragma mark - FrameCallback\n- (void)onCollectSuccess:(FrameRecord )record {\n NSLog(@\"\u2705 \u91c7\u96c6\u6210\u529f %@\", record.uploadTaskId);\n}\n- (void)onCollectFailureWithErrorCode:(NSInteger)code\n errorName:(NSString )name\n message:(NSString )msg {\n NSLog(@\"\u274c \u91c7\u96c6\u5931\u8d25 [%@] %@\", name, msg);\n}\n- (void)onReportSuccess:(FrameRecord )record { \/* ... \/ }\n- (void)onReportSkip:(FrameRecord )record reason:(NSString )reason { \/ ... \/ }\n- (void)onReportFailureWithErrorCode:(NSInteger)code\n errorName:(NSString )name\n message:(NSString )msg\n record:(FrameRecord )record { \/* ... \/ }\n@end\n```\n\n### A.4 \u539f\u751f\u5e7f\u544a\u63a5\u5165\n\n\u539f\u751f\u5e7f\u544a\uff08\u4e1a\u52a1\u65b9\u81ea\u6e32\u67d3\uff09\u4e0e Banner \u5171\u7528 `collectFrameFromAdContainer`\uff0c\u628a\u6e32\u67d3\u597d\u7684\u5bb9\u5668 view \u4f20\u5165\u5373\u53ef\uff1a\n\n```swift\nfunc nativeAdDidShow(_ nativeView: UIView) {\n MaterialMonitor.shared.collectFrameFromAdContainer(\n nativeView,\n adInfo: adInfo,\n timing: timing,\n options: FrameOptions(delayMs: 300), \/\/ \u539f\u751f\u7d20\u6750\u6e32\u67d3\u7a0d\u6162\uff0c\u7ed9 300ms\n callback: self\n )\n}\n```\n\n---","pure_content":"\u4e00\u3001\u7b80\u4ecb\n\n\n\nMaterialMonitor \u662f\u4e00\u6b3e\u5e7f\u544a\u7d20\u6750\u76d1\u6d4b SDK\uff0c\u7528\u4e8e\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u91c7\u96c6\u5e7f\u544a\u753b\u9762\u622a\u56fe\uff08\u542b\u89c6\u9891\u5e27\u5408\u6210\uff09+ \u5143\u6570\u636e\uff0c\u5e76\u81ea\u52a8\u4e0a\u4f20\u5230\u7d20\u6750\u5ba1\u8ba1\u670d\u52a1\u7aef\uff0c\u7528\u4e8e\u7d20\u6750\u5408\u89c4\u5ba1\u8ba1\u4e0e\u8d28\u91cf\u76d1\u6d4b\u3002\n\u4e0b\u8f7d\u5730\u5740\uff1ahttp:\/\/info.appsmartsite.com\/Material_monitor\/iOS_MaterialMonitor.zip\n\n\n\n\u6838\u5fc3\u80fd\u529b\n\n\n\n \u80fd\u529b\n \u8bf4\u660e\n\n\n\n\n \u622a\u56fe\u91c7\u96c6\n \u652f\u6301\u5f00\u5c4f \/ Banner \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891 \/ \u539f\u751f\u5e7f\u544a\n\n\n \u89c6\u9891\u5408\u6210\u622a\u56fe\n \u81ea\u52a8\u8bc6\u522b AVPlayerLayer \u5e76\u5408\u6210\u89c6\u9891\u5e27 + UIKit \u8986\u76d6\u5c42\n\n\n \u6301\u4e45\u5316\u961f\u5217\n \u6c99\u76d2\u843d\u76d8 + \u51b7\u542f\u52a8\u6062\u590d + \u91cd\u8bd5 + \u7f51\u7edc\u611f\u77e5\n\n\n \u81ea\u52a8\u4e0a\u62a5\n \u5185\u7f6e\u7b7e\u540d\uff08HMAC-MD5\uff09 + multipart \u4e0a\u4f20 + \u9650\u6d41\u91cd\u8bd5\u7b56\u7565\n\n\n \u9690\u79c1\u4fdd\u62a4\n \u81ea\u52a8\u906e\u76d6\u5bc6\u7801\u8f93\u5165\u6846 \/ firstResponder\uff0c\u652f\u6301\u81ea\u5b9a\u4e49\u906e\u76d6\u533a\u57df\n\n\n \u7b56\u7565\u611f\u77e5\n \u652f\u6301\u6309 placementId \/ networkFirmId \/ \u6837\u5f0f\u52a8\u6001\u542f\u505c\n\n\n\n\n\u4e8c\u3001\u521d\u59cb\u5316\u4e0e\u5173\u95ed\n2.1 \u521d\u59cb\u5316\uff08\u5fc5\u987b\uff09\n\u8c03\u7528\u65f6\u673a\uff1a\u5efa\u8bae\u5728 ATT \u6388\u6743\u56de\u8c03\u4e4b\u540e\u521d\u59cb\u5316\uff08\u786e\u4fdd IDFA \u53ef\u7528\uff09\uff0c\u6574\u4e2a App \u751f\u547d\u5468\u671f\u4ec5\u8c03\u7528\u4e00\u6b21\u3002\nSwift\nimport MaterialMonitorSDK\nimport AppTrackingTransparency\nimport AdSupport\n\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n\n \/\/ \u5efa\u8bae\u653e\u5728 applicationDidBecomeActive \u91cc\u8d70 ATT \u6388\u6743\u6d41\u7a0b\n func applicationDidBecomeActive(_ application: UIApplication) {\n if #available(iOS 14, ) {\n ATTrackingManager.requestTrackingAuthorization { _ in\n self.initMaterialMonitor()\n }\n } else {\n initMaterialMonitor()\n }\n }\n\n private func initMaterialMonitor() {\n let appId = \"your_app_id\"\n let appKey = \"your_app_key\"\n let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString\n let sdkVersion = \"your_host_sdk_version\" \/\/ \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\n\n \/\/ MARK: - MaterialMonitor SDK \u521d\u59cb\u5316\uff08\u5b8c\u6574\u53c2\u6570\uff09\n let config = MaterialMonitorConfig.Builder()\n \/\/ \u2500\u2500 \u4e0a\u4f20\u670d\u52a1\u5730\u5740\uff08\u7559\u7a7a\u5219\u4f7f\u7528 SDK \u5185\u7f6e\u9ed8\u8ba4\u5730\u5740\uff09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n \/\/ \u2500\u2500 \u9274\u6743 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .appId(appId)\n .appKey(appKey)\n \/\/ \u2500\u2500 \u8bbe\u5907\u6807\u8bc6\u7b26 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .idfa(idfa) \/\/ ATT \u6388\u6743\u540e\u4f20\u5165 ATTrackingManager.advertisingIdentifier.uuidString\n .idfv(nil) \/\/ nil \u65f6 SDK \u81ea\u52a8\u4ece UIDevice.current.identifierForVendor \u8bfb\u53d6\n .sdkVersion(sdkVersion) \/\/ \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\uff0c\u5199\u5165 meta device_info.sdk_version\n .caid(nil) \/\/ CAID\uff08\u4e2d\u56fd\u5e7f\u544a ID\uff0c\u53ef\u9009\uff09\n \/\/ \u2500\u2500 \u7f51\u7edc\u8d85\u65f6\uff08ms\uff09 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .connectTimeoutMs(15_000) \/\/ TCP \u8fde\u63a5\u8d85\u65f6\uff0c\u9ed8\u8ba4 15s\uff0c\u6700\u5c0f 3s\n .readTimeoutMs(30_000) \/\/ \u670d\u52a1\u7aef\u54cd\u5e94\u8d85\u65f6\uff0c\u9ed8\u8ba4 30s\uff0c\u6700\u5c0f 3s\n \/\/ \u2500\u2500 \u91cd\u8bd5\u7b56\u7565 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .maxUploadAttempts(3) \/\/ \u9996\u6b21 + \u6700\u591a 2 \u6b21\u91cd\u8bd5\uff0c\u6700\u5c0f 1\n .retryDelayMs([5_000, 15_000]) \/\/ \u5404\u6b21\u91cd\u8bd5\u7b49\u5f85\u65f6\u957f\uff08Swift \u4e13\u5c5e\uff09\n \/\/ \u2500\u2500 \u8c03\u8bd5\uff08\u751f\u4ea7\u73af\u5883\u8bf7\u4fdd\u6301 false\uff09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n .debugPerfLogging(false)\n .build()\n\n MaterialMonitor.initialize(config: config)\n }\n}\n\nObjective-C\n#import \n#import \n#import \n\n- (void)applicationDidBecomeActive:(UIApplication )application {\n if (@available(iOS 14, )) {\n [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {\n [self initMaterialMonitor];\n }];\n } else {\n [self initMaterialMonitor];\n }\n}\n\n- (void)initMaterialMonitor {\n NSString appId = @\"your_app_id\";\n NSString appKey = @\"your_app_key\";\n NSString idfa = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];\n NSString sdkVersion = @\"6.5.0\";\n\n MMConfigBuilder builder = [[MMConfigBuilder alloc] init];\n \/\/ \u2500\u2500 \u4e0a\u4f20\u670d\u52a1\u5730\u5740\uff08\u7559\u7a7a\u4f7f\u7528 SDK \u5185\u7f6e\u9ed8\u8ba4\uff09 \u2500\u2500\n [builder baseUploadUrl:@\"https:\/\/your-upload-host.com\"];\n \/\/ \u2500\u2500 \u9274\u6743 \u2500\u2500\n [builder appId:appId];\n [builder appKey:appKey];\n \/\/ \u2500\u2500 \u8bbe\u5907\u6807\u8bc6\u7b26 \u2500\u2500\n [builder idfa:idfa];\n [builder idfv:nil];\n [builder sdkVersion:sdkVersion];\n [builder caid:nil];\n \/\/ \u2500\u2500 \u7f51\u7edc\u8d85\u65f6\uff08ms\uff09 \u2500\u2500\n [builder connectTimeoutMs:15000];\n [builder readTimeoutMs:30000];\n \/\/ \u2500\u2500 \u91cd\u8bd5\u7b56\u7565\uff08ObjC \u4e0d\u652f\u6301\u81ea\u5b9a\u4e49 retryDelayMs\uff0c\u4f7f\u7528\u9ed8\u8ba4\u503c [5000, 15000]\uff09 \u2500\u2500\n [builder maxUploadAttempts:3];\n \/\/ \u2500\u2500 \u8c03\u8bd5\uff08\u751f\u4ea7\u73af\u5883\u8bf7\u4fdd\u6301 NO\uff09 \u2500\u2500\n [builder debugPerfLogging:NO];\n\n MaterialMonitorConfig config = [builder build];\n [MaterialMonitor initializeWithConfig:config];\n}\n\n\n\u63d0\u793a 1\uff1aMaterialMonitor \u662f\u5355\u4f8b\uff08MaterialMonitor.shared\uff09\uff0c\u521d\u59cb\u5316\u540e\u901a\u8fc7 MaterialMonitor.shared.xxx() \u8c03\u7528\u6240\u6709\u5b9e\u4f8b\u65b9\u6cd5\u3002\n\u63d0\u793a 2\uff1a\u6240\u6709\u53c2\u6570\u90fd\u6709\u5408\u7406\u9ed8\u8ba4\u503c\uff0c\u6700\u5c11\u5fc5\u586b appId \u548c appKey \u5373\u53ef\u5de5\u4f5c\uff1b\u5176\u4ed6\u53c2\u6570\u6309\u9700\u8986\u76d6\u3002\n\u63d0\u793a 3\uff1aObjC \u4e0d\u652f\u6301 retryDelayMs(_:)\uff08Swift \u6570\u7ec4\u6865\u63a5\u9650\u5236\uff09\uff0cObjC \u5de5\u7a0b\u4f7f\u7528\u5185\u7f6e\u9ed8\u8ba4 [5000, 15000]\u3002\n\n2.2 \u91cd\u65b0\u521d\u59cb\u5316\n\u5141\u8bb8\u5728\u8fd0\u884c\u4e2d\u91cd\u590d\u8c03\u7528 initialize(config:) \u2014\u2014 SDK \u4f1a\u81ea\u52a8 teardown \u65e7\u8c03\u5ea6\u5668\uff08\u53d6\u6d88\u5b9a\u65f6\u5668\u3001\u4e2d\u65ad\u5728\u9014\u8bf7\u6c42\u3001\u6e05\u7a7a\u56de\u8c03\uff09\uff0c\u518d\u7528\u65b0 config \u91cd\u5efa\u3002\u51b7\u542f\u52a8\u626b\u63cf\u4f1a\u91cd\u505a\uff0c\u78c1\u76d8\u5df2\u6709\u4efb\u52a1\u4fdd\u7559\u3002\n2.3 \u5173\u95ed SDK\nMaterialMonitor.shutdown()\n\n[MaterialMonitor shutdown];\n\n\u5173\u95ed\u540e\u884c\u4e3a\uff1a\n\n\n\n \u9879\n \u884c\u4e3a\n\n\n\n\n \u91c7\u96c6 \/ \u4e0a\u62a5\u65b9\u6cd5\n \u7acb\u5373\u8fd4\u56de MMErrorCodeUninitialized\n\n\n \u5728\u9014\u4e0a\u4f20\u8bf7\u6c42\n \u786c\u53d6\u6d88\uff08URLSession invalidateAndCancel\uff09\n\n\n \u91cd\u8bd5\u5b9a\u65f6\u5668\u3001\u7f51\u7edc\u76d1\u542c\n \u7acb\u5373\u91ca\u653e\n\n\n \u4e1a\u52a1\u56de\u8c03\u6ce8\u518c\u8868\n \u6e05\u7a7a\uff08\u5df2\u53d1\u51fa\u56de\u8c03\u6b63\u5e38\u6d3e\u53d1\uff0c\u540e\u7eed\u56de\u8c03\u9759\u9ed8\u4e22\u5f03\uff09\n\n\n \u78c1\u76d8\u5df2\u843d\u76d8\u8bb0\u5f55\n \u4fdd\u7559\uff0c\u4e0b\u6b21 initialize \u51b7\u542f\u52a8\u626b\u63cf\u65f6\u7ee7\u7eed\u4e0a\u62a5\n\n\n Config\n \u6e05\u7a7a\n\n\n\n\u5e42\u7b49:\u91cd\u590d\u8c03\u7528 shutdown() \u5b89\u5168\u3002\n\u53ef\u91cd\u542f\uff1ashutdown \u540e\u518d\u6b21 initialize \u53ef\u6062\u590d\u5168\u90e8\u529f\u80fd\u3002\n\n\u4e09\u3001\u914d\u7f6e\u9879 MaterialMonitorConfig\n\u901a\u8fc7 Builder \u6a21\u5f0f\u6784\u9020\u3002\u6240\u6709\u914d\u7f6e\u9879\u53ca\u9ed8\u8ba4\u503c\u5982\u4e0b\uff1a\n\n\n\n \u5b57\u6bb5\n \u7c7b\u578b\n \u9ed8\u8ba4\u503c\n \u8bf4\u660e\n\n\n\n\n baseUploadUrl\n String\n \u5185\u7f6e\u9ed8\u8ba4\u5730\u5740\n \u4e0a\u4f20\u6839\u57df\u540d\uff08\u5982 \"https:\/\/api.example.com\"\uff09\uff0cSDK \u81ea\u52a8\u62fc\u63a5 \/v1\/creative\/upload\u3002\u7559\u7a7a\u4f7f\u7528\u5185\u7f6e\u9ed8\u8ba4\u3002\n\n\n appId\n String\n \"\"\n \u5e94\u7528 ID\uff0c\u5199\u5165 multipart \u5b57\u6bb5 app_id\n\n\n appKey\n String\n \"\"\n HMAC-MD5 \u7b7e\u540d\u5bc6\u94a5\u3002\u4e25\u7981\u6253\u5370 \/ \u7f13\u5b58 \/ \u4e0a\u4f20\u660e\u6587\n\n\n idfa\n String?\n nil\n ATT \u6388\u6743\u540e\u7684 IDFA\u3002SDK \u76f4\u63a5\u900f\u4f20\uff0c\u4e0d\u8fc7\u6ee4\u5168 0 \u503c\n\n\n idfv\n String?\n nil\n IDFV\u3002nil \u65f6 SDK \u81ea\u52a8\u4ece UIDevice.current.identifierForVendor \u8bfb\u53d6\n\n\n sdkVersion\n String?\n nil\n \u5bbf\u4e3b\u805a\u5408 SDK \u7248\u672c\u53f7\uff0c\u5199\u5165 meta device_info.sdk_version\n\n\n caid\n String?\n nil\n CAID\uff08\u4e2d\u56fd\u5e7f\u544a ID\uff09\n\n\n connectTimeoutMs\n Int\n 15000\n TCP \u8fde\u63a5\u8d85\u65f6\uff08ms\uff09\uff0c\u6700\u5c0f\u503c 3000\n\n\n readTimeoutMs\n Int\n 30000\n \u670d\u52a1\u5668\u54cd\u5e94\u8d85\u65f6\uff08ms\uff09\uff0c\u6700\u5c0f\u503c 3000\n\n\n maxUploadAttempts\n Int\n 3\n \u6700\u5927\u4e0a\u4f20\u5c1d\u8bd5\u6b21\u6570\uff08\u9996\u53d1 + \u91cd\u8bd5\uff09\uff0c\u6700\u5c0f\u503c 1\n\n\n retryDelayMs\n [Int]\n [5000, 15000]\n \u5404\u6b21\u91cd\u8bd5\u7b49\u5f85\u65f6\u957f\uff08ms\uff09\u3002Swift \u4e13\u5c5e\uff0cObjC \u4f7f\u7528\u9ed8\u8ba4\u503c\n\n\n maxCacheSizeMb\n Int\n 100\n \u6c99\u76d2 material_monitor\/ \u603b\u5bb9\u91cf\u4e0a\u9650\uff08MB\uff09\uff0c\u6700\u5c0f\u503c 10\n\n\n debugPerfLogging\n Bool\n false\n \u542f\u7528\u8be6\u7ec6 Debug \u65e5\u5fd7\u3002\u751f\u4ea7\u73af\u5883\u52a1\u5fc5\u5173\u95ed\n\n\n\n\u5b8c\u6574\u6784\u9020\u793a\u4f8b\uff08Swift\uff09\nlet config = MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n .appId(appId)\n .appKey(appKey)\n .idfa(idfa) \/\/ ATT \u6388\u6743\u540e\u4f20\u5165\n .idfv(nil) \/\/ nil \u65f6 SDK \u81ea\u52a8\u8bfb\u53d6\n .sdkVersion(sdkVersion)\n .connectTimeoutMs(15_000)\n .readTimeoutMs(30_000)\n .maxUploadAttempts(3)\n .retryDelayMs([5_000, 15_000])\n .debugPerfLogging(false)\n .build()\n\n\n\u56db\u3001\u91c7\u96c6\u63a5\u53e3\nSDK \u63d0\u4f9b\u4e24\u79cd\u91c7\u96c6\u63a5\u53e3\uff0c\u6309\u5e7f\u544a\u662f\u5426\u6709\u53ef\u8bbf\u95ee\u7684\u5bb9\u5668\u89c6\u56fe\u9009\u62e9\uff1a\n\n\n\n \u5e7f\u544a\u5f62\u6001\n \u9002\u7528\u7c7b\u578b\n \u63a8\u8350\u63a5\u53e3\n\n\n\n\n \u6709\u5bb9\u5668\n Banner \/ \u539f\u751f\u5e7f\u544a\n collectFrameFromAdContainer\n\n\n \u65e0\u5bb9\u5668\n \u5f00\u5c4f \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891\n collectFrameFromAdPage\n\n\n\n\n\u6240\u6709\u91c7\u96c6\u65b9\u6cd5\u5fc5\u987b\u5728\u4e3b\u7ebf\u7a0b\u8c03\u7528\u3002\u622a\u56fe\u91c7\u96c6\u4e0e\u4e0a\u62a5\u56de\u8c03\u5747\u5728\u4e3b\u7ebf\u7a0b\u6d3e\u53d1\u3002\n\n4.1 \u6709\u5bb9\u5668\u5e7f\u544a\uff08Banner \/ \u539f\u751f\u5e7f\u544a\uff09\npublic func collectFrameFromAdContainer(\n _ view: UIView,\n adInfo: MMAdInfo,\n timing: AdTimingInput,\n options: FrameOptions,\n callback: FrameCallback\n)\n\n\u53c2\u6570\uff1a\n\n\n\n \u53c2\u6570\n \u7c7b\u578b\n \u8bf4\u660e\n\n\n\n\n view\n UIView\n \u5e7f\u544a\u5bb9\u5668\u89c6\u56fe\n\n\n adInfo\n MMAdInfo\n \u5e7f\u544a\u4fe1\u606f\uff08\u89c1 \u00a77.4\uff09\n\n\n timing\n AdTimingInput\n \u5e7f\u544a\u65f6\u95f4\u6233\uff08\u89c1 \u00a77.1\uff09\n\n\n options\n FrameOptions\n \u622a\u56fe\u9009\u9879\uff08\u89c1 \u00a77.2\uff09\n\n\n callback\n FrameCallback\n \u91c7\u96c6 + \u81ea\u52a8\u4e0a\u62a5\u56de\u8c03\uff08\u5f31\u5f15\u7528\uff0c\u89c1 \u00a76\uff09\n\n\n\nSwift \u793a\u4f8b\uff08Banner\uff09\uff1a\nfunc onBannerAdShow(_ bannerView: UIView, extra: [String: Any]) {\n MaterialMonitor.shared.collectFrameFromAdContainer(\n bannerView,\n adInfo: buildMMAdInfo(extra),\n timing: buildTiming(extra),\n options: FrameOptions(delayMs: 200), \/\/ Banner \u5ef6\u8fdf\u53ef\u8f83\u77ed\n callback: self\n )\n}\n\n4.2 \u65e0\u5bb9\u5668\u5e7f\u544a\uff08\u5f00\u5c4f \/ \u63d2\u5c4f \/ \u6fc0\u52b1\u89c6\u9891\uff09\npublic func collectFrameFromAdPage(\n adInfo: MMAdInfo,\n timing: AdTimingInput,\n options: FrameOptions,\n callback: FrameCallback\n)\n\nSDK \u4f1a\u81ea\u52a8\u5b9a\u4f4d\u6700\u9876\u5c42 presentedViewController \u7684 view\uff0c\u82e5\u4e0d\u5b58\u5728\u5219\u622a keyWindow\u3002\nSwift \u793a\u4f8b\uff08\u5f00\u5c4f\uff09\uff1a\nfunc splashAdDidShow() {\n MaterialMonitor.shared.collectFrameFromAdPage(\n adInfo: adInfo,\n timing: timing,\n options: FrameOptions(delayMs: 3000), \/\/ \u5f00\u5c4f\u89c6\u9891\u8f83\u957f\uff0c\u7ed9\u5145\u8db3\u6e32\u67d3\u65f6\u95f4 \u6beb\u79d2\n callback: self\n )\n}\n\n\n\u4e94\u3001\u624b\u52a8\u4e0a\u62a5\u4e0e\u961f\u5217\u7ba1\u7406\n5.1 \u624b\u52a8\u5165\u961f\u4e0a\u62a5\n\u628a\u5df2\u6709\u7684 FrameRecord \u91cd\u65b0\u5165\u961f\uff08\u573a\u666f\uff1a\u4e1a\u52a1\u4fa7\u5ef6\u540e\u4e0a\u62a5\u3001\u8de8\u8fdb\u7a0b\u6062\u590d\uff09\u3002\npublic func reportFrameRecord(\n _ record: FrameRecord,\n adInfo: MMAdInfo,\n callback: ReportCallback?\n)\n\n\u8bf4\u660e\uff1a\n\n\nrecord \u5fc5\u987b\u662f\u4e4b\u524d\u901a\u8fc7 collectFrame* \u62ff\u5230\u7684\uff08\u542b\u5408\u6cd5 localFilePath\uff09\n\u89e6\u53d1 show_id \u548c upload_task_id \u53cc\u91cd\u53bb\u91cd\n\ncallback \u53ef\u9009\uff0c\u4ec5\u5173\u5fc3\u4e0a\u62a5\u7ed3\u679c\n\n5.2 \u7acb\u5373\u89e6\u53d1\u5f85\u4e0a\u4f20\u4efb\u52a1\nMaterialMonitor.shared.flushPendingUploads()\n\n\u901a\u5e38\u65e0\u9700\u624b\u52a8\u8c03\u7528 \u2014\u2014 SDK \u5728\u91c7\u96c6\u6210\u529f \/ \u7f51\u7edc\u6062\u590d \/ \u91cd\u8bd5\u5230\u671f\u65f6\u81ea\u52a8\u89e6\u53d1\u3002\n5.3 \u67e5\u8be2\u8bb0\u5f55\n\/\/ Swift\nlet records = MaterialMonitor.shared.getRecords(style: .banner)\n\n\/\/ ObjC\uff08\u6309 adType \u6574\u6570\uff09\nNSArray records = [[MaterialMonitor shared] getRecordsForAdType:2];\n\n\u8fd4\u56de\u975e dead \u72b6\u6001\uff08pending \/ uploading \/ retryWaiting\uff09\u7684\u6240\u6709\u8bb0\u5f55\u3002\n5.4 \u5220\u9664\u8bb0\u5f55\nMaterialMonitor.shared.deleteRecord(record)\n\n\u884c\u4e3a\u5206\u652f\uff1a\n\n\n\n \u5f53\u524d\u72b6\u6001\n \u884c\u4e3a\n\n\n\n\n pending \/ retryWaiting\n \u7acb\u5373\u5220\u9664\u6587\u4ef6\u5bf9\uff0c\u4e0d\u89e6\u53d1\u56de\u8c03\n\n\n uploading\n \u6807\u8bb0\u4e3a dead\uff0cHTTP \u5b8c\u6210\u540e\u9759\u9ed8\u5220\u9664\n\n\n dead\n \u7acb\u5373\u5220\u9664\u6587\u4ef6\u5bf9\n\n\n\n5.5 \u83b7\u53d6\u5f53\u524d\u914d\u7f6e\nlet config = MaterialMonitor.shared.getConfig()\n\n\u672a\u521d\u59cb\u5316\u6216\u5df2 shutdown \u65f6\u8fd4\u56de nil\u3002\n\n\u516d\u3001\u56de\u8c03\u534f\u8bae\n6.1 FrameCallback\uff08\u91c7\u96c6 + \u4e0a\u62a5\uff09\n@objc public protocol FrameCallback: AnyObject {\n func onCollectSuccess(_ record: FrameRecord)\n func onCollectFailure(errorCode: Int, errorName: String, message: String)\n func onReportSuccess(_ record: FrameRecord)\n func onReportSkip(_ record: FrameRecord, reason: String)\n func onReportFailure(errorCode: Int, errorName: String, message: String, record: FrameRecord?)\n}\n\n\n\n\n \u56de\u8c03\n \u89e6\u53d1\u65f6\u673a\n\n\n\n\n onCollectSuccess\n \u622a\u56fe\u6210\u529f + \u843d\u76d8 + \u5165\u961f\n\n\n onCollectFailure\n \u622a\u56fe\u6216\u5165\u961f\u5931\u8d25\uff08\u4e0d\u4f1a\u518d\u89e6\u53d1\u540e\u7eed\u4e0a\u62a5\u56de\u8c03\uff09\n\n\n onReportSuccess\n \u670d\u52a1\u7aef\u8fd4\u56de code=0\n\n\n onReportSkip\n show_id \u5df2\u5b58\u5728\uff08duplicated_show_id\uff09\n\n\n onReportFailure\n \u91cd\u8bd5\u8017\u5c3d \/ \u9274\u6743\u5931\u8d25 \/ \u53c2\u6570\u9519\u8bef \/ \u914d\u989d\u8017\u5c3d\u7b49\u7ec8\u6001\n\n\n\n6.2 ReportCallback\uff08\u4ec5\u4e0a\u62a5\uff09\nreportFrameRecord \u4f7f\u7528\uff0c\u7b7e\u540d\u540c FrameCallback \u7684\u4e0a\u62a5\u90e8\u5206\u3002\n6.3 \u5173\u952e\u7279\u6027 \u26a0\ufe0f\n\n\n\u6240\u6709\u56de\u8c03\u5728\u4e3b\u7ebf\u7a0b\u6d3e\u53d1\uff0c\u53ef\u76f4\u63a5\u8bbf\u95ee UI\n\n\u56de\u8c03\u91c7\u7528\u5f31\u5f15\u7528\uff08weak\uff09\uff0cViewController \u91ca\u653e\u540e\u56de\u8c03\u9759\u9ed8\u4e22\u5f03\uff0c\u4e0d\u4f1a\u6cc4\u6f0f\n\n\u91c7\u96c6\u6d41\u7a0b\u8fdb\u884c\u4e2d\uff08delay + \u622a\u56fe + \u538b\u7f29 + \u843d\u76d8\uff09callback \u88ab\u5f3a\u5f15\u7528\u6301\u6709\uff0cVC \u5728\u6b64\u671f\u95f4\u4e0d\u4f1a\u88ab\u91ca\u653e\uff08\u6700\u957f ~3 \u79d2 + \u5904\u7406\u65f6\u95f4\uff09\uff0c\u9700\u6ce8\u610f\n\n\n\u4e03\u3001\u6570\u636e\u6a21\u578b\n7.1 AdTimingInput\npublic init(requestTimeMs: Int64, fillTimeMs: Int64, showTimeMs: Int64)\n\n\u5e7f\u544a\u5404\u9636\u6bb5\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\u3002\u4fbf\u5229\u6784\u9020\uff1a\nlet timing = AdTimingInput.sameWallClockMs(Int64(Date().timeIntervalSince1970 1000))\n\n7.2 FrameOptions\npublic init(\n delayMs: Int = 500,\n maxSizeKb: Int = 300,\n maxLongEdge: Int = 1080,\n keepQualityFirst: Bool = true,\n excludeViews: [UIView] = []\n)\n\n\n\n\n \u5b57\u6bb5\n \u9ed8\u8ba4\n \u8bf4\u660e\n\n\n\n\n delayMs\n 500\n \u7b49\u5f85\u5e7f\u544a\u7d20\u6750\u52a0\u8f7d\u5b8c\u6210\u7684\u5ef6\u8fdf\uff08ms\uff09\u3002\u89c6\u9891\u5e7f\u544a\u5efa\u8bae 2000+\uff0cBanner\u3001\u539f\u751f 200~300 \u5373\u53ef\n\n\n maxSizeKb\n 300\n JPEG \u538b\u7f29\u76ee\u6807\u6700\u5927\u4f53\u79ef\uff08KB\uff09\n\n\n maxLongEdge\n 1080\n \u843d\u76d8 JPEG \u6700\u957f\u8fb9\u50cf\u7d20\u4e0a\u9650\n\n\n keepQualityFirst\n true\n \u662f\u5426\u4f18\u5148\u4fdd\u8bc1\u56fe\u50cf\u8d28\u91cf\uff08\u4ece 0.7 \u8d77\u964d\u8d28\u91cf\uff09\n\n\n excludeViews\n []\n \u9700\u8981\u906e\u76d6\u7684\u5b50\u89c6\u56fe\uff08\u9690\u79c1\u533a\u57df\uff0c\u5982\u81ea\u5b9a\u4e49\u5bc6\u7801\u6846\uff09\n\n\n\n7.3 FrameRecord\n\u4ee3\u8868\u4e00\u6b21\u91c7\u96c6\u7ed3\u679c\u3002\u4e1a\u52a1\u65b9\u4e00\u822c\u53ea\u8bfb\u4f7f\u7528\u3002\n\n\n\n \u5b57\u6bb5\n \u7c7b\u578b\n \u8bf4\u660e\n\n\n\n\n showId\n String\n \u5e7f\u544a\u5c55\u793a ID\uff08\u670d\u52a1\u7aef\u5e42\u7b49\u53bb\u91cd\u952e\uff09\n\n\n uploadTaskId\n String\n SDK \u5185\u90e8 UUID\n\n\n placementId\n String\n \u5e7f\u544a\u4f4d ID\n\n\n style\n MaterialStyle\n \u5e7f\u544a\u6837\u5f0f\uff08Swift\uff09\n\n\n adType\n Int\n \u5e7f\u544a\u7c7b\u578b\u6574\u6570\uff08ObjC \u53cb\u597d\uff09\n\n\n requestTimeMs \/ fillTimeMs \/ showTimeMs\n Int64\n \u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\n\n\n imageUrl\n String?\n \u539f\u751f\u7d20\u6750 URL\uff08\u4ec5 native \u573a\u666f\uff09\n\n\n localFilePath\n String\n \u6c99\u76d2\u7edd\u5bf9\u8def\u5f84\n\n\n imageHash\n String\n pHash\uff0816 \u5b57\u7b26\u5c0f\u5199 hex\uff09\n\n\n createdAt\n Int64\n \u91c7\u96c6\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\n\n\n\n7.4 MMAdInfo\n\u5e7f\u544a\u4fe1\u606f\uff0c\u4e1a\u52a1\u65b9\u5728 onAdShow \u56de\u8c03\u4e2d\u6784\u9020\uff1a\n\n\n\n \u5b57\u6bb5\n \u7c7b\u578b\n \u5fc5\u586b\n \u8bf4\u660e\n\n\n\n\n requestId\n String\n \u2705\n \u8bf7\u6c42 ID\n\n\n showId\n String\n \u2705\n \u5e7f\u544a\u5c55\u793a\u552f\u4e00 ID\uff08\u5e42\u7b49\u53bb\u91cd\u952e\uff09\n\n\n placementId\n String\n \u2705\n \u5e7f\u544a\u4f4d ID\n\n\n adSourceId\n String\n \u2705\n \u5e7f\u544a\u6e90 ID\n\n\n adNetworkFirmId\n Int\n \u2705\n \u5e7f\u544a\u7f51\u7edc ID\n\n\n adType\n Int\n \u2705\n \u5e7f\u544a\u7c7b\u578b\u6574\u6570\uff1a0=Native \/ 1=RewardedVideo \/ 2=Banner \/ 3=Interstitial \/ 4=Splash\n\n\n requestTimestamp\n Int64\n \u2705\n \u8bf7\u6c42\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\n\n\n fillTimestamp\n Int64\n \u2705\n \u586b\u5145\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\n\n\n showTimestamp\n Int64\n \u2705\n \u5c55\u793a\u65f6\u95f4\u6233\uff08\u6beb\u79d2\uff09\n\n\n creativeId\n String?\n \u9009\n \u521b\u610f ID\uff08\u90e8\u5206\u5e7f\u544a\u7f51\u7edc\u4e0d\u8fd4\u56de\uff09\n\n\n ecpm\n NSNumber?\n \u9009\n eCPM\n\n\n sceneId\n String?\n \u9009\n \u573a\u666f ID\n\n\n\n7.5 MaterialStyle\n\n\n\n \u679a\u4e3e\u503c\n adType\n rawValue\n\n\n\n\n .native\n 0\n \"native\"\n\n\n .rewarded\n 1\n \"rewarded\"\n\n\n .banner\n 2\n \"banner\"\n\n\n .interstitial\n 3\n \"interstitial\"\n\n\n .splash\n 4\n \"splash\"\n\n\n\n\n\u516b\u3001\u9519\u8bef\u7801\nMMErrorCode \u679a\u4e3e\uff08ObjC \u7528 MMErrorCodeXxx \u524d\u7f00\uff09\uff1a\n\u91c7\u96c6\u9519\u8bef\uff081xxx\uff09\n\n\n\n \u6570\u5b57\u503c\n errorName\n \u542b\u4e49\n \u662f\u5426\u53ef\u91cd\u8bd5\n\n\n\n\n 1001\n VIEW_INVALID\n View \u4e3a nil \u6216\u672a attached \u5230 window\n \u274c\n\n\n 1002\n SCENE_INVALID\n keyWindow \u627e\u4e0d\u5230\u6216\u9876\u5c42 VC \u5df2 dismiss\n \u274c\n\n\n 1003\n COLLECT_FAILED\n \u622a\u56fe\u5931\u8d25\uff08\u5982 view \u5df2\u91ca\u653e\uff09\n \u274c\n\n\n 1004\n COMPRESS_FAILED\n JPEG \u538b\u7f29\u5931\u8d25\n \u274c\n\n\n\n\u4e0a\u62a5\u9519\u8bef\uff082xxx\uff09\n\n\n\n \u6570\u5b57\u503c\n errorName\n \u542b\u4e49\n \u662f\u5426\u53ef\u91cd\u8bd5\n\n\n\n\n 2001\n PARAMS_INVALID\n \u5fc5\u586b\u53c2\u6570\u7f3a\u5931\u6216\u975e\u6cd5\n \u274c\n\n\n 2002\n NETWORK_ERROR\n \u7f51\u7edc\u8bf7\u6c42\u5931\u8d25 \/ \u8d85\u65f6\n \u2705\n\n\n 2003\n AUTH_FAILED\n \u9274\u6743\u5931\u8d25\uff08\u68c0\u67e5 appId \/ appKey\uff09\n \u274c\n\n\n 2004\n RETRY_EXHAUSTED\n \u91cd\u8bd5\u6b21\u6570\u8017\u5c3d\n \u274c\n\n\n 2005\n UNINITIALIZED\n SDK \u672a\u521d\u59cb\u5316\u6216\u5df2 shutdown\n \u274c\n\n\n 2006\n NOT_READY\n \u4e0a\u4f20\u914d\u7f6e\u4e0d\u5168\uff08appId \/ appKey \u7f3a\u5931\uff09\n \u274c\n\n\n 2007\n STRATEGY_DISABLED\n \u5f53\u524d\u5e7f\u544a\u4f4d\u88ab\u7b56\u7565\u5173\u95ed\n \u274c\n\n\n\n\n\u4e5d\u3001\u5e38\u89c1\u95ee\u9898\u3001\u6ce8\u610f\u4e8b\u9879\u4e0e\u63a8\u8350\u914d\u7f6e\nQ1\uff1a\u5fc5\u987b\u5728\u4e3b\u7ebf\u7a0b\u8c03\u7528\u91c7\u96c6\u5417\uff1f\n\u662f\u3002SDK \u5185\u90e8 assert(Thread.isMainThread)\uff0c\u975e\u4e3b\u7ebf\u7a0b\u8c03\u7528\u4f1a\u89e6\u53d1 assert\uff08DEBUG \u5305\u5d29\u6e83\uff0cRelease \u5305\u884c\u4e3a\u672a\u5b9a\u4e49\uff09\u3002\nQ2\uff1a\u91c7\u96c6\u5ef6\u8fdf\uff08delayMs\uff09\u8be5\u600e\u4e48\u8bbe\uff1f\n\n\n\n \u5e7f\u544a\u7c7b\u578b\n \u63a8\u8350\u5ef6\u8fdf\n\n\n\n\n Banner\n 200ms\n\n\n \u63d2\u5c4f\n 500ms\n\n\n \u6fc0\u52b1\u89c6\u9891\n 1000ms\n\n\n \u5f00\u5c4f\n 2000~3000ms\uff08\u89c6\u9891\u5f00\u5c4f\u7ed9\u8db3\u6e32\u67d3\u65f6\u95f4\uff09\n\n\n Native\n 200~500ms\uff08\u4e1a\u52a1\u65b9\u6e32\u67d3\u8f83\u5feb\uff09\n\n\n\nQ3\uff1a\u56de\u8c03\u91cc record.localFilePath \u4f55\u65f6\u53ef\u7528\uff1f\nonCollectSuccess \u4e4b\u540e sandbox \u6587\u4ef6\u5df2\u5b58\u5728\uff1bonReportSuccess \/ onReportFailure \u4e4b\u540e\u6587\u4ef6\u53ef\u80fd\u5df2\u88ab\u6e05\u7406\uff0c\u4e0d\u8981\u5728\u4e0a\u62a5\u56de\u8c03\u91cc\u8bfb localFilePath\u3002\nQ4\uff1a\u5185\u5b58\u5360\u7528\u4e0e\u78c1\u76d8\u7a7a\u95f4\uff1f\n\n\n\u5185\u5b58\uff1a\u6bcf\u6b21\u91c7\u96c6\u5cf0\u503c\u7ea6 = \u622a\u56fe\u539f\u56fe\u4f53\u79ef\uff084\u00d7\u5bbd\u00d7\u9ad8 \u5b57\u8282\uff0c1080p \u7ea6 8MB\uff09+ JPEG \u4e34\u65f6 buffer\u3002\u538b\u7f29\u5b8c\u6210\u540e\u91ca\u653e\n\n\u78c1\u76d8\uff1a\u9ed8\u8ba4\u4e0a\u9650 100MB\uff08maxCacheSizeMb\uff09\uff0c\u8d85\u51fa\u540e\u51b7\u542f\u52a8\u626b\u63cf\u4f1a\u6309 createdAt \u6392\u5e8f\u5220\u9664\u6700\u8001\u7684 dead \u8bb0\u5f55\n\nQ5\uff1a\u89c6\u9891\u5e7f\u544a\u622a\u56fe\u662f\u9ed1\u5c4f \/ \u89c6\u9891\u753b\u9762\u7f3a\u5931\uff1f\niOS \u7cfb\u7edf\u7ea7\u9650\u5236\uff1a\n\n\u2705 AVPlayerLayer \u6e32\u67d3\u7684\u89c6\u9891 \u2014\u2014 SDK \u5df2\u5b9e\u73b0\u5408\u6210\n\u274c AVSampleBufferDisplayLayer \u2014\u2014 \u65e0\u6cd5\u62bd\u5e27\n\u274c CAMetalLayer \/ CAEAGLLayer \u2014\u2014 \u65e0\u6cd5\u62bd\u5e27\n\u274c DRM \u4fdd\u62a4\u5185\u5bb9 \u2014\u2014 \u7cfb\u7edf\u7981\u6b62\u62bd\u5e27\n\n\u5bf9\u4e8e\u540e\u4e09\u79cd\u60c5\u51b5\uff0ciOS \u7cfb\u7edf\u7ea7\u522b\u65e0\u6cd5\u4ece\u5e94\u7528\u8fdb\u7a0b\u5185\u62bd\u5e27\u3002\u82e5\u9700\u89c6\u9891\u7d20\u6750\u76d1\u6d4b\uff0c\u5efa\u8bae\u7531\u670d\u52a1\u7aef\u901a\u8fc7\u5e7f\u544a\u7f51\u7edc\u4e0b\u53d1\u7684\u7d20\u6750 URL \u76f4\u63a5\u62c9\u53d6\u5206\u6790\u3002\nQ6\uff1adebugPerfLogging \u8be5\u5f00\u542f\u5417\uff1f\n\u4ec5\u5728\u8054\u8c03\u671f\u5f00\u542f\u3002\u5f00\u542f\u540e\u4f1a\u901a\u8fc7 print \u8f93\u51fa\u5927\u91cf Debug \u65e5\u5fd7\uff1a\n\n\u6027\u80fd\u635f\u8017\uff1a\u6bcf\u6b21\u622a\u56fe \/ \u4e0a\u4f20\u589e\u52a0\u7ea6 5ms\n\u9690\u79c1\u98ce\u9669\uff1a\u65e5\u5fd7\u4e2d\u542b app_id \/ sign \/ meta JSON \u7b49\u5b57\u6bb5\n\n\u751f\u4ea7\u73af\u5883\u5fc5\u987b\u5173\u95ed\n\n\nQ7\uff1aAPP \u8fdb\u5165\u540e\u53f0\u540e\u8fd8\u4f1a\u7ee7\u7eed\u4e0a\u4f20\u5417\uff1f\n\u4f1a\uff0c\u76f4\u5230\u7cfb\u7edf\u6302\u8d77 App\u3002SDK \u4f7f\u7528\u666e\u901a URLSession\uff0c\u4e0d\u652f\u6301\u540e\u53f0\u4f20\u8f93\u3002\u82e5 App \u88ab\u6740\u6b7b\uff0c\u672a\u4e0a\u4f20\u7684\u4efb\u52a1\u4f1a\u5728\u4e0b\u6b21\u51b7\u542f\u52a8\u65f6\u6062\u590d\uff08pending \u72b6\u6001\uff09\u3002\nQ8\uff1a\u5982\u4f55\u5bf9\u63a5 ObjC \u5de5\u7a0b\uff1f\nSDK \u5168\u9762 @objc \u6807\u6ce8\u3002\u9700\u8981\uff1a\n\n\u5728 Bridging-Header.h \u4e2d\u5bfc\u5165\uff1a#import \n\nObjC Builder \u7c7b\u540d\uff1aMMConfigBuilder\n\n\u5b9e\u73b0\u534f\u8bae\uff1a@interface MyVC : UIViewController \n\n\n\n\u9644\u5f55 A\uff1a\u5b8c\u6574\u63a5\u5165\u793a\u4f8b\nA.1 AppDelegate \u521d\u59cb\u5316\nimport MaterialMonitorSDK\nimport AppTrackingTransparency\nimport AdSupport\n\n@main\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n\n func application(_ application: UIApplication,\n didFinishLaunchingWithOptions launchOptions: [...]?) -> Bool {\n \/\/ ATT \u6388\u6743\u540e\u518d\u521d\u59cb\u5316\uff08\u63a8\u8350\uff09\n if #available(iOS 14, ) {\n ATTrackingManager.requestTrackingAuthorization { status in\n DispatchQueue.main.async {\n self.setupMaterialMonitor()\n }\n }\n } else {\n setupMaterialMonitor()\n }\n return true\n }\n\n private func setupMaterialMonitor() {\n let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString\n\n let config = MaterialMonitorConfig.Builder()\n .baseUploadUrl(\"https:\/\/your-upload-host.com\")\n .appId(\"your_app_id\")\n .appKey(\"your_app_key\")\n .idfa(idfa)\n .sdkVersion(\"6.5.0\")\n .debugPerfLogging(false)\n .build()\n\n MaterialMonitor.initialize(config: config)\n }\n}\n\nA.2 Banner \u63a5\u5165\nextension MyViewController: FrameCallback {\n\n func onBannerAdShow(_ bannerView: UIView, extra: [String: Any]) {\n let adInfo = buildMMAdInfo(from: extra)\n\n MaterialMonitor.shared.collectFrameFromAdContainer(\n bannerView,\n adInfo: adInfo,\n timing: adInfo.timingInput,\n options: FrameOptions(delayMs: 200),\n callback: self\n )\n }\n\n \/\/ MARK: FrameCallback\n func onCollectSuccess(_ record: FrameRecord) {\n print(\"\u2705 \u91c7\u96c6\u6210\u529f taskId=\\(record.uploadTaskId)\")\n }\n func onCollectFailure(errorCode: Int, errorName: String, message: String) {\n print(\"\u274c \u91c7\u96c6\u5931\u8d25 [\\(errorName)] \\(message)\")\n }\n func onReportSuccess(_ record: FrameRecord) {\n print(\"\u2705 \u4e0a\u62a5\u6210\u529f showId=\\(record.showId)\")\n }\n func onReportSkip(_ record: FrameRecord, reason: String) {\n print(\"\u23ed \u4e0a\u62a5\u8df3\u8fc7\uff1a\\(reason)\")\n }\n func onReportFailure(errorCode: Int, errorName: String,\n message: String, record: FrameRecord?) {\n print(\"\u274c \u4e0a\u62a5\u5931\u8d25 [\\(errorName)] \\(message)\")\n }\n}\n\nA.3 ObjC Banner \u63a5\u5165\n#import \n\n@interface MyViewController () \n@end\n\n@implementation MyViewController\n\n- (void)onBannerAdShow:(UIView )bannerView extra:(NSDictionary )extra {\n MMAdInfo adInfo = [self buildMMAdInfoFromExtra:extra];\n AdTimingInput timing = [[AdTimingInput alloc]\n initWithRequestTimeMs:adInfo.requestTimestamp\n fillTimeMs:adInfo.fillTimestamp\n showTimeMs:adInfo.showTimestamp];\n FrameOptions options = [[FrameOptions alloc] init];\n\n [[MaterialMonitor shared] collectFrameFromAdContainer:bannerView\n adInfo:adInfo\n timing:timing\n options:options\n callback:self];\n}\n\n#pragma mark - FrameCallback\n- (void)onCollectSuccess:(FrameRecord )record {\n NSLog(@\"\u2705 \u91c7\u96c6\u6210\u529f %@\", record.uploadTaskId);\n}\n- (void)onCollectFailureWithErrorCode:(NSInteger)code\n errorName:(NSString )name\n message:(NSString )msg {\n NSLog(@\"\u274c \u91c7\u96c6\u5931\u8d25 [%@] %@\", name, msg);\n}\n- (void)onReportSuccess:(FrameRecord )record { \/* ... \/ }\n- (void)onReportSkip:(FrameRecord )record reason:(NSString )reason { \/ ... \/ }\n- (void)onReportFailureWithErrorCode:(NSInteger)code\n errorName:(NSString )name\n message:(NSString )msg\n record:(FrameRecord )record { \/* ... *\/ }\n@end\n\nA.4 \u539f\u751f\u5e7f\u544a\u63a5\u5165\n\u539f\u751f\u5e7f\u544a\uff08\u4e1a\u52a1\u65b9\u81ea\u6e32\u67d3\uff09\u4e0e Banner \u5171\u7528 collectFrameFromAdContainer\uff0c\u628a\u6e32\u67d3\u597d\u7684\u5bb9\u5668 view \u4f20\u5165\u5373\u53ef\uff1a\nfunc nativeAdDidShow(_ nativeView: UIView) {\n MaterialMonitor.shared.collectFrameFromAdContainer(\n nativeView,\n adInfo: adInfo,\n timing: timing,\n options: FrameOptions(delayMs: 300), \/\/ \u539f\u751f\u7d20\u6750\u6e32\u67d3\u7a0d\u6162\uff0c\u7ed9 300ms\n callback: self\n )\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1782963259","update_time":"1782963958"},"pure_content":"\u4e00\u3001\u7b80\u4ecb\n\n\n\nMaterialMonitor \u662f\u4e00\u6b3e\u5e7f\u544a\u7d20\u6750\u76d1\u6d4b SDK\uff0c\u7528\u4e8e\u5728\u5e7f\u544a\u5c55\u793a\u65f6\u91c7\u96c6\u5e7f\u544a\u753b\u9762\u622a\u56fe\uff08\u542b\u89c6\u9891\u5e27\u5408\u6210\uff09+ \u5143\u6570\u636e\uff0c\u5e76\u81ea\u52a8\u4e0a\u4f20\u5230\u7d20\u6750\u5ba1\u8ba1\u670d\u52a1\u7aef\uff0c\u7528\u4e8e\u7d20\u6750\u5408\u89c4\u5ba1\u8ba1\u4e0e\u8d28\u91cf\u76d1\u6d4b\u3002\n\u4e0b\u8f7d\u5730\u5740\uff1ahttp:\/\/info.appsmartsite.com\/Material_monitor\/iOS_MaterialMonitor.zip\n\n\n\n\u6838\u5fc3\u80fd\u529b\n\n\n\n \u80fd\u529b\n \u8bf4\u660e\n\n\n\n\n \u622a\u56fe\u91c7\u96c6"}],"content":{"icon":"","desc":"","content_id":"853989","add_time":"1782962722","update_time":"1782962722","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}

广告素材探测