简介这份资源是面向苹果CMS站长与安卓开发者的原生App对接方案提供安卓原生客户端与配套后端用于将苹果CMS站点快速封装为独立App解决移动端访问与视频分类读取问题。压缩包共843个文件以438个js脚本、100个css样式、60个php后端接口、73个png图标及47个jpg图片为主另含sql数据库文件、字体与配置文件整体约14.92MB结构完整便于二次修改。后端支持独立域名部署或与苹果CMS同目录建文件夹放置PHP建议7.0至7.4需修改database.php并共用同一数据库导入SQL后访问域名即可默认账号admin、密码123456App图标须为100KB以内的png格式。目前已有102人学习下载适合想低成本搭建自有视频App、研究原生端与CMS数据联动的开发者参考可省去从零设计接口与页面样式的时间。1. 安卓原生对接苹果CMS为什么“套壳”方案正在被淘汰如果你手上有苹果CMS站点又打算做一个安卓端大概率会先搜到一堆“套壳打包”方案把移动端网页塞进 WebView改个图标就上架。这条路在 2024 年之后越来越难走——安卓 14 对 WebView 的权限收紧、应用市场对“纯网页壳”的审核趋严、用户对卡顿和闪退的容忍度也在下降。所谓“最新优化版安卓原生对接苹果CMS App后端app”讲的其实就是另一条路安卓端用原生控件渲染数据通过苹果CMS自带的 API 接口拉取后端不额外写一套业务逻辑直接复用 CMS 的数据库和采集体系。这样做的好处很直接采集规则、分类、播放源这些运营侧的东西完全不用动安卓端只负责“把接口数据画出来”。适合谁适合已经有苹果CMS站点、想低成本补一个安卓入口的站长也适合接外包时被要求“做个 App 但预算只够改 CMS”的开发者。下面按我实际落地的顺序拆开讲。2. 苹果CMS 接口层先搞清楚后端到底能给你什么2.1 苹果CMS 原生 API 的三种数据出口苹果CMS常见的是 V10 版本对外提供数据的路径主要有三条选错一条后面全白干。第一条是api.php/provide/vod/这类标准采集接口返回 JSON字段固定适合做列表和详情第二条是index.php/ajax/系列比如data、vod这些返回结构更贴近模板变量适合做首页聚合第三条是直接读数据库性能最好但耦合最重除非你要做实时搜索否则不建议。我一般会先打开浏览器访问你的域名/api.php/provide/vod/?aclist看能不能拿到{code:1,msg:数据列表,list:[...]}这种结构。如果返回的是 HTML 或者 404说明伪静态或路由没配好这时候别急着写安卓代码先把接口调通。# 先确认接口是否可用注意替换成你自己的域名 curl -s https://你的域名/api.php/provide/vod/?aclistpg1 | head -c 500 # 正常应该看到 JSON如果看到 !DOCTYPE html 说明被伪静态拦截了上面这条命令的作用是快速验证接口出口。参数aclist表示拉列表pg1是第一页。如果返回 HTML常见原因是 Nginx 的try_files把api.php也重写了需要在伪静态规则里加一条location /api.php { ... }放行。这一步不通过后面安卓端所有请求都会拿到一坨网页源码解析直接崩。2.2 接口字段与安卓端数据模型的映射苹果CMS 列表接口返回的字段名是固定的比如vod_id、vod_name、vod_pic、vod_remarks、vod_play_url。安卓端如果直接用 Gson 或 Moshi 映射类名最好和字段一一对应别自作聪明改短名否则后期加字段容易漏。我一般会建一个VodItem数据类字段用SerializedName显式标注这样即使后端哪天把vod_pic改成vod_pic_thumb改一处注解就行。详情接口acdetailids1返回的vod_play_url是一个用$$$分隔剧集、用$分隔标题和地址的字符串安卓端必须自己写解析器不能直接当 URL 用。// 解析 vod_play_url 的典型写法注意分隔符顺序 fun parsePlayUrl(raw: String): ListPlayEpisode { // 格式第1集$http://a.m3u8$$$第2集$http://b.m3u8 return raw.split($$$).mapNotNull { group - val parts group.split($) if (parts.size 2) PlayEpisode(parts[0], parts[1]) else null } }这段代码的关键在于先按$$$拆剧集再按$拆标题和地址。参数说明raw是接口原样返回的字符串不能先做 URL 解码否则$可能被转义。踩过的坑是有些采集源会在标题里带$符号导致parts.size变成 3这时候取parts[0]和parts[1]仍然安全但如果你用parts.last()就会拿到错误地址。2.3 用 Retrofit 封装一个可切换域名的请求层安卓原生对接苹果CMS最怕的是域名被封或者换站。我一般用 Retrofit OkHttp把 baseUrl 做成可配置的存在 SharedPreferences 里这样用户端不用发版就能换线。拦截器里统一加User-Agent有些 CMS 会根据 UA 返回不同模板加一个固定 UA 能避免拿到移动端 HTML。超时时间设 10 秒苹果CMS 在采集高峰期响应会变慢设太短会频繁超时设太长用户体验差。val okHttp OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(15, TimeUnit.SECONDS) .addInterceptor { chain - val request chain.request().newBuilder() .header(User-Agent, Mozilla/5.0 (Linux; Android 13) AppleWebKit/537.36) .build() chain.proceed(request) } .build() val retrofit Retrofit.Builder() .baseUrl(prefs.getString(base_url, https://你的域名/)) .client(okHttp) .addConverterFactory(GsonConverterFactory.create()) .build()参数说明connectTimeout控制握手时间readTimeout控制数据读取时间苹果CMS 的api.php在数据量大时可能超过 10 秒所以读超时给到 15 秒。baseUrl必须以/结尾否则 Retrofit 会拼错路径。这个请求层建好之后后面所有接口调用都走它换域名只需要改一个字符串。3. 安卓端原生渲染把接口数据画成能用的界面3.1 列表页用 RecyclerView Paging 的落地参数列表页是用户停留最久的地方用 RecyclerView 配合 Paging 3 可以做到滑到哪加载到哪。苹果CMS 的aclist接口支持pg参数每页默认 20 条我一般会改成 30 条减少请求次数。PagingSource 里把pg作为 keyprevKey和nextKey根据返回的pagecount和total判断。这里有个细节苹果CMS 返回的pagecount有时候是字符串有时候是数字解析时要兼容。class VodPagingSource(private val api: VodApi) : PagingSourceInt, VodItem() { override suspend fun load(params: LoadParamsInt): LoadResultInt, VodItem { val page params.key ?: 1 return try { val resp api.getList(ac list, pg page) LoadResult.Page( data resp.list, prevKey if (page 1) null else page - 1, nextKey if (page resp.pagecount) null else page 1 ) } catch (e: Exception) { LoadResult.Error(e) } } }逻辑说明params.key为空时默认第一页nextKey用pagecount判断是否还有下一页。参数ac固定为listpg是页码。注意苹果CMS 的pagecount字段在部分版本里叫pagecount部分叫totalpage上线前先用 curl 看一眼实际返回。如果拿不到就退化成“返回条数小于 30 就认为没有下一页”虽然不精确但能用。3.2 详情页与播放器的对接方式详情页拿到vod_play_url之后解析出剧集列表点击某一集时把地址传给播放器。安卓原生播放器我一般用 ExoPlayer现在叫 Media3它支持 HLS 和 MP4苹果CMS 的采集源大多是 m3u8正好匹配。这里的关键是不要直接把 m3u8 地址丢给系统播放器系统播放器对 HLS 的支持参差不齐ExoPlayer 更稳。播放器初始化时设置setMediaItem然后prepare和play。val player ExoPlayer.Builder(context).build() player.setMediaItem(MediaItem.fromUri(episodeUrl)) player.prepare() player.play()参数说明episodeUrl来自上一步解析出的地址必须是完整 URL不能是相对路径。如果采集源返回的是//开头的协议相对地址要手动补上https:。踩过的坑是有些源返回的 m3u8 里嵌套了密钥地址ExoPlayer 默认能处理但如果密钥地址是内网 IP就会一直转圈这时候要在播放器回调里监听Player.Listener.onPlayerError给用户一个“换源”按钮。3.3 搜索与分类筛选的原生实现搜索接口用acdetailwd关键词返回结构和列表类似。分类筛选用aclistt分类ID分类 ID 可以从aclist的返回里拿也可以自己在后台看。安卓端我一般用 SearchView 加一个 debounce300 毫秒内不重复请求。分类筛选用 ChipGroup选中后重新触发 PagingSource。这里要注意苹果CMS 的搜索接口对特殊字符敏感用户输入%或时要先做 URL 编码否则接口会返回空。val encoded URLEncoder.encode(keyword, UTF-8) val resp api.search(ac detail, wd encoded)参数说明wd是搜索词必须编码。acdetail在搜索场景下也能用返回的是匹配的详情列表。如果搜索无结果苹果CMS 返回的list是空数组不是 null所以判空用isEmpty()而不是 null。4. 避坑与排查对接苹果CMS 时最容易翻车的五件事4.1 接口返回 HTML 而不是 JSON现象安卓端解析报JsonSyntaxException抓包看到返回的是!DOCTYPE html。原因伪静态规则把api.php也重写了或者 CMS 后台关闭了 API 功能。解决在 Nginx 里加location /api.php { try_files $uri 404; }并检查后台“系统设置-API设置”是否开启。如果用的是宝塔面板直接在伪静态里把api.php排除。4.2 图片加载失败但接口里有地址现象列表能显示文字封面全是占位图。原因苹果CMS 返回的vod_pic可能是相对路径或者图片做了防盗链。解决安卓端拼接域名前缀用 Glide 加载时加RequestOptions设置setReferer为你的域名。如果图片服务器有防盗链这个 Referer 必须和 CMS 域名一致。4.3 播放地址解析出来是空的现象详情页有剧集标题但点进去播放器黑屏。原因vod_play_url的分隔符不是标准的$$$有些采集源用#或者$$。解决先打印原始字符串看实际分隔符然后写一个兼容函数按$$$、#、$$依次尝试。不要硬编码一种。4.4 换域名后 App 全部请求失败现象CMS 换了域名App 不更新就废了。原因baseUrl 写死在代码里。解决把 baseUrl 做成远程配置启动时先请求一个固定的配置接口比如你自己的短链或者 GitHub Raw拿到最新域名再初始化 Retrofit。这个配置接口要极简返回一个 JSON 就行。4.5 上架应用市场被拒现象提交审核被拒理由是“内容来源不明”或“纯网页壳”。原因原生比例不够或者没有内容审核机制。解决确保列表、详情、播放都是原生控件WebView 只用于“关于我们”这种静态页。另外在后台加一个举报入口审核时能加分。如果做的是影视类很多市场需要资质这个要提前确认。5. 进阶技巧用本地缓存和预加载把体验拉满接口对接通了之后真正拉开差距的是缓存策略。苹果CMS 的接口在采集更新后数据会变但用户端不需要每次打开都拉最新。我一般用 Room 做两级缓存列表页缓存 5 分钟详情页缓存 30 分钟播放地址不缓存因为可能失效。OkHttp 自带的Cache也能用但控制粒度不如 Room 细。具体做法是 PagingSource 里先读 Room有数据就先返回同时后台请求网络拿到新数据再刷新。这样冷启动时用户几乎感觉不到等待。// 先读缓存再请求网络 val cached dao.queryPage(page) if (cached.isNotEmpty()) { // 先发射缓存数据 emit(LoadResult.Page(cached, prevKey, nextKey)) } // 再请求网络并写入数据库 val remote api.getList(ac list, pg page) dao.insertAll(remote.list)参数说明dao.queryPage按页码查缓存insertAll用OnConflictStrategy.REPLACE覆盖旧数据。注意缓存要设过期时间否则用户永远看不到新采集的剧集。我一般会在VodItem里加一个cachedAt字段查询时过滤掉超过 5 分钟的。另一个技巧是预加载播放地址。用户在详情页点击某一集之前其实已经能看到剧集列表这时候可以在后台用协程预请求下一集的 m3u8等用户真的点击时直接播放。但要注意流量消耗只在 Wi-Fi 下做预加载。这个功能加上之后用户感知的“秒开”率会明显提升。最后说一个我自己的习惯每次对接新的苹果CMS 站点先不写安卓代码而是用 Postman 把aclist、acdetail、acdetailwd这三个请求各跑一遍把返回的 JSON 存下来当测试数据。这样安卓端开发时不用依赖网络用本地 JSON 就能调试解析逻辑。等解析没问题了再切到真实接口。这个习惯帮我省了至少一半的联调时间。希望帮到你。本文还有配套的精品资源点击获取