音视频系统开发 示意图
ORANGEZH / 交付案例

音频 APP 矩阵|iOS(Swift / Objective-C)、安卓、H5、Flutter 多端共用内容接口

面向音频内容产品:iOS、安卓、H5 与 Flutter 跨端共用一套内容接口,收听进度多端同步。

约 8 分钟读完 5 条买家问答 关键事实可核验
项目结构 · 按本案例交付内容提取音频 APP 矩阵内容多端分发进度与列表同步推荐位运营统一内容接口行业 · 文化与传媒SwiftiOS 音频端Objective-CiOS

项目概览

客户是谁

某音频内容产品项目。

遇到什么问题

这是一套音频内容的多端产品矩阵,终端形态包括 iOS 音频端(Swift)、iOS 端(Objective-C)、安卓端、H5 与运营端(Vue,存在多个并行版本),以及 Flutter 跨端应用(Dart),后端接口服务用 Java 编写,多个产品线接入同一套内容接口。产品线之间有先后,也各自受过当时技术选型的影响。

这类产品的麻烦通常不在某一个端,而在于端多之后的一致性:

  • 用户今天在手机上听到第 20 分钟,明天换设备打开,进度接不上,体验就断了;
  • 运营在后台调整了推荐位与播放列表,如果各端各自缓存、各自解释数据,同一份内容在不同端看到的结果就会不一样;
  • 历史上积累下来的多个前端版本并行存在,改动分散在几套代码里,维护成本被放大,也没有人能一口说清影响范围;
  • 内容运营的节奏比研发快,运营做一次调整如果要各端都改代码,排期就永远排不完。

我们做了什么

  • 把内容接口收敛成一套:各端只做展示差异,不做内容规则。接口层设计要求更高、联调更频繁,换来的是新增一个端不必重写内容逻辑。
  • 把收听进度与播放列表放到服务端维护:这比各端本地存储复杂,也需要处理冲突,但用户换设备之后体验才是连续的。
  • 接受多版本前端并存,先收敛接口而不是立即合并代码:合并会带来大量回归风险,短期内保留并行、用统一接口约束各版本。
  • 服务层承载内容数据、收听进度与播放列表状态;运营端负责推荐位与播放列表编排,内容调整通过接口一次性下发,而不是逐端配置。

难点怎么解决的

  • 同一份内容要在各端上一致:内容规则只有一份,各端只做展示差异;各端各写一套的话,规则会随时间分叉,最后没人说得清哪套是对的。
  • 换设备进度不能丢:收听进度与播放列表由服务端维护,需要处理冲突,但体验才连续。
  • 历史并行的前端版本不能硬合并:先用统一接口把数据口径固定住,再逐步收敛版本。
  • 运营节奏比研发快:内容调整通过接口一次下发,不必逐端配置,也不必等各端排期。

交付了什么

  • iOS 音频端(Swift)与 iOS 端(Objective-C);
  • 安卓端与后端接口服务(Java);
  • H5 与运营端(Vue,多个版本并行);
  • Flutter 跨端应用(Dart);
  • 内容接口、收听进度与播放列表同步机制。

交付范围到内容接口与多端能力为止:内容版权与授权由内容方按协议提供,平台不承担版权审核责任;音频源文件的存储与分发以既有或签约方案为准;第三方渠道的账号与结算规则按其平台规则执行,系统不改写这些规则。

现在的状态

代码处于持续维护状态。

项目信息

客户

某音视频内容平台项目

行业

文化与传媒

项目周期

未披露

技术栈

Swift(iOS 音频端)/ Objective-C(iOS)/ Java(安卓端与接口服务)/ Vue(H5 与运营端,多版本)/ Dart(Flutter 跨端)

服务类型

影音内容多端产品矩阵

CHALLENGES

客户当时面对的现实

01

同一份内容要分发到 iOS 音频端、iOS、安卓端、H5 与跨端,如果各端各写一套内容逻辑,口径必然分叉

02

收听进度与播放列表要跨端接续,用户换设备后状态必须接得上

03

多个产品线共用同一套内容接口,接口一改会同时影响所有端

04

H5 与运营端存在多个 Vue 版本并行,版本管理本身占用维护成本

CAPABILITIES

我们交付的能力

端一多,一致性就成了主要问题

内容多端分发

iOS 音频端(Swift)、iOS 端(Objective-C)、安卓端、H5 与 Flutter 跨端各自有对应实现,共用同一套内容接口。

进度与列表同步

收听进度与播放列表状态由服务端维护,换设备后可以接续上次的位置。

推荐位运营

运营端负责推荐位与播放列表的编排,改动通过接口下发给各端,而不是逐端配置。

统一内容接口

多个产品线接入同一套内容接口,内容规则只有一份,不随端和产品线扩散。

SCOPE

交付范围

以下范围按本项目实际交付内容与边界整理,不属于这次范围的部分一并列出。

已交付

  • iOS 音频端(Swift)与 iOS 端(Objective-C)
  • 安卓端与后端接口服务(Java)
  • H5 与运营端(Vue,多个版本并行)
  • Flutter 跨端应用(Dart)
  • 内容接口、收听进度与播放列表同步机制

不在本次范围

  • 内容版权与授权:内容由内容方按协议提供,平台不承担版权审核责任
  • 音视频源文件的存储与分发:以既有或签约的存储与分发方案为准
  • 第三方渠道的账号与结算规则:按其平台规则执行,不由系统改写

ARCHITECTURE

分层技术架构

公开口径归纳为三层:接入层是 iOS、安卓、H5 与跨端四类终端;服务层是 Java 接口服务,承载内容数据与用户状态;运营层是 Vue 运营端,负责推荐位与播放列表编排。

FLOW 01

多端接入层

iOS 音频端(Swift) iOS 端(Objective-C) 安卓端 H5 Flutter 跨端

覆盖用户实际使用的各类设备

FLOW 02

内容服务层

内容接口 收听进度与播放列表 用户状态

让内容规则与用户状态只有一份

FLOW 03

运营层

推荐位编排 播放列表维护 运营后台

内容调整一次下发,各端同步生效

DELIVERY

交付过程

分阶段推进,每个阶段都有可验收的产出,客户在早期就能看到实际效果。

阶段一

端与内容边界梳理

明确要覆盖哪些端、内容数据由谁维护、状态如何同步。

阶段二

接口服务与内容模型

搭建统一内容接口,确定内容与播放列表的数据结构。

阶段三

多端落地

iOS、安卓、H5、运营端与跨端应用分别接入同一套接口。

阶段四

同步与运营能力

收听进度跨端同步、推荐位与播放列表运营能力落地。

FACTS

可核验的交付事实

以下内容来自本项目实际交付物;未经验证的指标不予展示。

5类技术栈

Swift / Objective-C / Java / Vue / Dart

4个端

iOS / 安卓 / H5 / Flutter 跨端

1套内容接口

内容口径与收听进度多端共用

TRANSFER

这套做法适不适合你

案例的用处不是证明"我们做过",而是让你判断"在我们这种条件下能不能做成"。下面三句是我们对这一单的判断,写下来供你对照自己的情况。

适合什么情况

适合内容要覆盖多类终端、且用户会在设备之间切换的产品。

什么情况下别照搬

若只做一个端、用户不会跨设备使用,做统一内容接口与状态同步属于过度设计。

如果要试,第一步做什么

先把内容数据与用户状态的接口边界画出来,再决定各端做什么。

RELATED SERVICES

相关服务

从实际业务问题出发,查看对应服务的适用场景、交付物与不含项;具体范围仍需单独确认。

FAQ

常见问题

以下是同类项目沟通中出现频率最高的问题,答案就是我们实际的做法。

多端产品最难的为什么不是界面?
界面各端本来就不一样。真正难的是内容口径与用户状态的一致性——同一份内容在各端看到的结果不同,或者换设备进度丢了,这类问题在用户侧是致命的,但它们都发生在接口与状态层。
多个产品线共用一套内容接口,会不会互相拖累?
会带来耦合,但比各建一套更可控。共用接口意味着规则只有一份,改动的影响面是可枚举的;各建一套的话,规则会随着时间慢慢分叉,最后没人说得清哪套是对的。
H5 和运营端为什么会有多个版本?
产品迭代过程中出现的并行版本,是历史积累的结果。我们没有一次性强行合并,因为合并的回归成本很高,先用统一接口约束住各版本,再逐步收敛。
这套东西现在还在维护吗?
代码处于持续维护状态。各条产品线的活跃度不完全一致。
做多端内容产品第一步做什么?
先把内容与用户状态的接口边界划清楚——哪些数据必须由服务端统一维护,哪些可以各端本地处理。这条线画错,后面每个端都要返工。

本页最后更新:2026年9月28日

下一步

聊聊你的内容要覆盖几个端

从端清单、内容接口边界到状态同步方案,一起确认第一期覆盖范围。

商务联系人卢刚
商务联系人微信二维码 微信扫码加商务联系人,
发需求文档或截图都行。