diff --git a/zh-cn/application-dev/media/video-playback.md b/zh-cn/application-dev/media/video-playback.md
index 0f976e3aff824c7e55806cc8acbb498e0c77c768..cb7610269fe9bd1bb94979fb9a009ec26601ac75 100644
--- a/zh-cn/application-dev/media/video-playback.md
+++ b/zh-cn/application-dev/media/video-playback.md
@@ -20,6 +20,19 @@
 2. 三方应用把surfaceID传递给VideoPlayer JS。
 3. 媒体服务把帧数据flush给surface buffer。
 
+## 兼容性说明
+
+推荐使用视频软件主流的播放格式和主流分辨率，不建议开发者自制非常或者异常码流，以免产生无法播放、卡住、花屏等兼容性问题。若发生此类问题不会影响系统，退出码流播放即可。
+
+主流的播放格式和主流分辨率如下：
+
+| 视频容器规格 |                     规格描述                      |               分辨率               |
+| :----------: | :-----------------------------------------------: | :--------------------------------: |
+|     mp4      | 视频格式：H264/MPEG2/MPEG4/H263 音频格式：AAC/MP3 | 主流分辨率，如1080P/720P/480P/270P |
+|     mkv      | 视频格式：H264/MPEG2/MPEG4/H263 音频格式：AAC/MP3 | 主流分辨率，如1080P/720P/480P/270P |
+|      ts      |   视频格式：H264/MPEG2/MPEG4 音频格式：AAC/MP3    | 主流分辨率，如1080P/720P/480P/270P |
+|     webm     |          视频格式：VP8 音频格式：VORBIS           | 主流分辨率，如1080P/720P/480P/270P |
+
 ## 开发步骤
 
 详细API含义可参考：[js-apis-media.md](../reference/apis/js-apis-media.md)