@meshstream/docs-mcp 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -2
- package/content/ai-coding.md +161 -0
- package/content/api/bootstrap.md +67 -0
- package/content/api/errors.md +34 -0
- package/content/best-practices.md +145 -0
- package/content/billing/usage.md +38 -0
- package/content/concepts/identity.md +23 -0
- package/content/concepts/multi-region.md +15 -0
- package/content/concepts/p2p.md +79 -0
- package/content/concepts/statistics.md +52 -0
- package/content/intro.md +54 -0
- package/content/legal/privacy.md +110 -0
- package/content/legal/terms.md +173 -0
- package/content/quickstart.md +198 -0
- package/content/sdk/android-advanced.md +228 -0
- package/content/sdk/android-setup.md +139 -0
- package/content/sdk/android.md +190 -0
- package/content/sdk/flutter-advanced.md +285 -0
- package/content/sdk/flutter-setup.md +123 -0
- package/content/sdk/flutter.md +91 -0
- package/content/sdk/ios-advanced.md +268 -0
- package/content/sdk/ios-setup.md +113 -0
- package/content/sdk/ios.md +156 -0
- package/content/sdk/overview.md +40 -0
- package/content/sdk/react-native-advanced.md +269 -0
- package/content/sdk/react-native-setup.md +86 -0
- package/content/sdk/react-native.md +52 -0
- package/content/sdk/uniapp-advanced.md +274 -0
- package/content/sdk/uniapp-setup.md +92 -0
- package/content/sdk/uniapp.md +55 -0
- package/content/sdk/web-advanced.md +241 -0
- package/content/sdk/web-setup.md +42 -0
- package/content/sdk/web.md +105 -0
- package/content/sdk/windows-advanced.md +237 -0
- package/content/sdk/windows-setup.md +53 -0
- package/content/sdk/windows.md +162 -0
- package/content/troubleshooting.md +122 -0
- package/package.json +31 -4
- package/src/catalog.mjs +249 -0
- package/src/server.mjs +74 -0
|
@@ -0,0 +1,285 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Flutter SDK 高级用法
|
|
3
|
+
sidebar_label: 高级用法
|
|
4
|
+
description: "Flutter SDK 高级用法:直播点播、MP4/MP3、源站鉴权、预加载、运行时控制、监控与生命周期。"
|
|
5
|
+
pagination_label: "Flutter SDK 高级用法"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Flutter SDK 高级用法
|
|
9
|
+
|
|
10
|
+
本页按原生 SDK 的接入场景组织:直播/点播、文件直链、每路配置、预加载、运行时控制、监控与平台策略。示例复用[快速接入](./flutter.md)创建的 client,播放器变量由业务应用持有。
|
|
11
|
+
|
|
12
|
+
## 直播与点播接入策略
|
|
13
|
+
|
|
14
|
+
SDK 自动识别直播/点播,[基础接入方式相同](./flutter.md)。播放期间可回传播放器状态,帮助 P2P 调度;不回传也可正常播放。
|
|
15
|
+
|
|
16
|
+
### 直播
|
|
17
|
+
|
|
18
|
+
<span id="直播回传缓冲余量" />
|
|
19
|
+
|
|
20
|
+
<span id="缓冲反馈" />
|
|
21
|
+
|
|
22
|
+
回传当前位置之后连续可播放的缓冲时长,帮助 SDK 调整 P2P 预取。例如播放到 60 秒、缓冲到 70 秒,应传 **10,000 毫秒**。直播起播位置与目标延迟由播放器设置。
|
|
23
|
+
|
|
24
|
+
```dart
|
|
25
|
+
await session.updateBufferedDurationMs(bufferedDurationMs);
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### 点播(VOD)
|
|
29
|
+
|
|
30
|
+
<span id="点播另外回传播放位置" />
|
|
31
|
+
|
|
32
|
+
<span id="播放进度与缓冲反馈" />
|
|
33
|
+
|
|
34
|
+
除缓冲时长外,回传当前播放位置,帮助 SDK 在已连接且拥有目标分片的 Peer 中优先选择进度接近的节点。Seek 完成后立即更新位置。
|
|
35
|
+
|
|
36
|
+
```dart
|
|
37
|
+
await session.updateCurrentPositionMs(positionMs);
|
|
38
|
+
await session.updateBufferedDurationMs(bufferedDurationMs);
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
数值均为非负毫秒,缓冲时长不能跨越断档。播放器状态有效后通常每秒回传一次;关闭会话前停止回传并等待在途调用结束。
|
|
42
|
+
|
|
43
|
+
<span id="播放器状态回传" />
|
|
44
|
+
|
|
45
|
+
<span id="播放位置与连续缓冲" />
|
|
46
|
+
|
|
47
|
+
<span id="播放器状态同步" />
|
|
48
|
+
|
|
49
|
+
<span id="接入示例" />
|
|
50
|
+
|
|
51
|
+
<span id="播放器状态回传示例" />
|
|
52
|
+
|
|
53
|
+
<details>
|
|
54
|
+
<summary>完整播放器状态回传示例</summary>
|
|
55
|
+
|
|
56
|
+
示例使用 `video_player` 的 `controller` 和当前 `session`,仅计算当前位置之后连续的缓冲区间。
|
|
57
|
+
|
|
58
|
+
```dart
|
|
59
|
+
Future<void> syncPlaybackState({required bool isLive}) async {
|
|
60
|
+
final value = controller.value;
|
|
61
|
+
if (!value.isInitialized || value.position.isNegative) return;
|
|
62
|
+
final position = value.position;
|
|
63
|
+
var bufferedEnd = position;
|
|
64
|
+
final ranges = [...value.buffered]
|
|
65
|
+
..sort((a, b) => a.start.compareTo(b.start));
|
|
66
|
+
for (final range in ranges) {
|
|
67
|
+
if (range.end < bufferedEnd) continue;
|
|
68
|
+
if (range.start > bufferedEnd) break;
|
|
69
|
+
bufferedEnd = range.end;
|
|
70
|
+
}
|
|
71
|
+
if (!isLive) {
|
|
72
|
+
await session.updateCurrentPositionMs(position.inMilliseconds);
|
|
73
|
+
}
|
|
74
|
+
await session.updateBufferedDurationMs(
|
|
75
|
+
(bufferedEnd - position).inMilliseconds,
|
|
76
|
+
);
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
</details>
|
|
81
|
+
|
|
82
|
+
## MP4 / MP3 直链播放
|
|
83
|
+
|
|
84
|
+
MP4 与 MP3 使用文件直链。为同一内容设置稳定的 `contentId`;地址没有扩展名时显式指定 `mimeType`:
|
|
85
|
+
|
|
86
|
+
```dart
|
|
87
|
+
final session = await client.createPlaybackSession(
|
|
88
|
+
PlaybackSessionOptions(
|
|
89
|
+
url: 'https://cdn.example.com/video/trailer.mp4',
|
|
90
|
+
contentId: 'trailer-2026',
|
|
91
|
+
mimeType: MeshStreamMimeType.mp4,
|
|
92
|
+
),
|
|
93
|
+
);
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
将 `session.playbackUrl` 交给支持该格式的播放器。MP3 只需替换媒体地址并将类型设为 `mp3`。文件加速要求源站支持单区间 HTTP Range 请求,并返回有效的 `Content-Range`;不满足条件时不启用 P2P 加速,实际播放与拖动结果仍取决于源站和播放器。SDK 不负责解码,也不绕过 DRM。
|
|
97
|
+
|
|
98
|
+
## 每路播放配置与源站鉴权
|
|
99
|
+
|
|
100
|
+
<span id="动态地址与源站鉴权" />
|
|
101
|
+
|
|
102
|
+
客户端配置用于创建 client,每个媒体资源的参数在创建 session 时单独传入:
|
|
103
|
+
|
|
104
|
+
| 层级 | 参数 | 用途 |
|
|
105
|
+
| --- | --- | --- |
|
|
106
|
+
| Client | `key` | 对应应用和平台的 SDK Key |
|
|
107
|
+
| Client | `p2pEnabled` | 初始 P2P 意愿,仍受控制台策略约束 |
|
|
108
|
+
| Session | `url` | 必填的原始媒体地址 |
|
|
109
|
+
| Session | `contentId` | 同一内容的稳定标识 |
|
|
110
|
+
| Session | `mimeType` | `m3u8`、`mpd`、`mp4` 或 `mp3` |
|
|
111
|
+
| Session | `originHeaders` | 仅发给媒体源的请求头 |
|
|
112
|
+
|
|
113
|
+
播放地址带短期签名时,为同一媒体资源传入稳定的 `contentId`。没有文件扩展名时显式指定 `mimeType`;只发给源站的鉴权请求头通过 `originHeaders` 传入:
|
|
114
|
+
|
|
115
|
+
```dart
|
|
116
|
+
final session = await client.createPlaybackSession(
|
|
117
|
+
PlaybackSessionOptions(
|
|
118
|
+
url: signedUrl,
|
|
119
|
+
contentId: 'movie-2026-001',
|
|
120
|
+
mimeType: MeshStreamMimeType.mp4,
|
|
121
|
+
originHeaders: {'Authorization': 'Bearer $originToken'},
|
|
122
|
+
),
|
|
123
|
+
);
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
`originHeaders` 只用于访问媒体源,不会发送给其他 Peer。不要把 SDK Key、源站 Token 或完整签名 URL 写入日志和分析事件。签名续期由业务层完成,续期后为同一内容继续使用相同的 `contentId`。
|
|
127
|
+
|
|
128
|
+
## 预加载与内容切换
|
|
129
|
+
|
|
130
|
+
<span id="多会话与预加载" />
|
|
131
|
+
|
|
132
|
+
显式 `preload` 是可选的 HLS/DASH 预热:后台获取清单与首个媒体分片,不会下载整部视频。它也可提前启动 Tracker/Peer 连接,但排队成功不保证 Peer 已连接或媒体已就绪。尚未播放的候选会话不会向 Peer 上传媒体。MP4/MP3 直链不使用这条显式预加载流程。
|
|
133
|
+
|
|
134
|
+
保存候选会话,选中时复用其播放地址。关闭任一会话前,先停止状态回传、等待在途调用结束并取消其事件订阅,避免回调访问已关闭的会话。预加载不负责解码器准备,也不会渲染首帧。
|
|
135
|
+
|
|
136
|
+
<span id="预加载与多个会话" />
|
|
137
|
+
|
|
138
|
+
列表或连播场景可以提前创建下一条内容的会话:
|
|
139
|
+
|
|
140
|
+
### 准备候选内容
|
|
141
|
+
|
|
142
|
+
```dart
|
|
143
|
+
final next = await client.createPlaybackSession(
|
|
144
|
+
PlaybackSessionOptions(
|
|
145
|
+
url: nextItem.url,
|
|
146
|
+
contentId: nextItem.id,
|
|
147
|
+
mimeType: MeshStreamMimeType.m3u8,
|
|
148
|
+
),
|
|
149
|
+
);
|
|
150
|
+
|
|
151
|
+
final queued = await next.preload();
|
|
152
|
+
if (queued) {
|
|
153
|
+
// 用户真正切换时再把 next.playbackUrl 交给播放器。
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
`preload()` 返回 `true` 只表示本次预热已排队,不代表首帧或下载已经完成。每个播放器使用独立的 session;候选会话被丢弃时及时关闭,避免长期占用连接。
|
|
158
|
+
|
|
159
|
+
### 切换至候选内容
|
|
160
|
+
|
|
161
|
+
真正切换时,先从播放器解除旧媒体引用并关闭旧会话,再使用 `next.playbackUrl`,把 `next` 保留为当前会话。预加载不会驱动播放器,排队成功也不代表 Peer 已就绪;预热可能产生网络流量。
|
|
162
|
+
|
|
163
|
+
### 取消候选内容
|
|
164
|
+
|
|
165
|
+
若取消候选内容,则关闭它:
|
|
166
|
+
|
|
167
|
+
```dart
|
|
168
|
+
await next.close();
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## 运行时控制
|
|
172
|
+
|
|
173
|
+
<span id="p2p-开关与降级" />
|
|
174
|
+
|
|
175
|
+
### P2P 开关
|
|
176
|
+
|
|
177
|
+
灰度或排障时可以针对单个会话临时关闭 P2P:
|
|
178
|
+
|
|
179
|
+
```dart
|
|
180
|
+
await session.setP2pEnabled(false);
|
|
181
|
+
// 播放器继续使用同一个 session.playbackUrl。
|
|
182
|
+
await session.setP2pEnabled(true);
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
P2P、Tracker 或配置不可用时,播放器继续使用 `session.playbackUrl` 走 CDN。不要因为 `p2pUnavailable`、Peer 数为零或某次请求回源就替换播放地址或中断播放。
|
|
186
|
+
|
|
187
|
+
## 事件与监控
|
|
188
|
+
|
|
189
|
+
<span id="事件统计与诊断" />
|
|
190
|
+
|
|
191
|
+
按会话过滤事件,并在关闭会话前取消订阅:
|
|
192
|
+
|
|
193
|
+
```dart
|
|
194
|
+
final events = MeshStream.eventsFor(
|
|
195
|
+
clientId: client.clientId, sessionId: session.sessionId,
|
|
196
|
+
);
|
|
197
|
+
final subscription = events.listen((event) {
|
|
198
|
+
switch (event.type) {
|
|
199
|
+
case MeshStreamEventName.p2pUnavailable:
|
|
200
|
+
debugPrint('P2P unavailable: ${event.reason}');
|
|
201
|
+
break;
|
|
202
|
+
case MeshStreamEventName.cdnFallback:
|
|
203
|
+
debugPrint('CDN bytes: ${event.bytes}');
|
|
204
|
+
break;
|
|
205
|
+
case MeshStreamEventName.statistics:
|
|
206
|
+
debugPrint('peers=${event.statistics?.connectedPeers}');
|
|
207
|
+
break;
|
|
208
|
+
default:
|
|
209
|
+
break;
|
|
210
|
+
}
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
final stats = await session.getStats();
|
|
214
|
+
final diagnostics = await session.getDiagnostics();
|
|
215
|
+
final status = await client.getStatus();
|
|
216
|
+
|
|
217
|
+
await subscription.cancel();
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
`cdnFallback` 表示某次请求使用了 CDN,不代表整个会话已经切换到 CDN。最终是否可播放应以播放器状态和媒体源响应为准。
|
|
221
|
+
|
|
222
|
+
| 字段 | 含义 |
|
|
223
|
+
| --- | --- |
|
|
224
|
+
| `httpDownloaded` | HTTP/CDN 下载字节 |
|
|
225
|
+
| `p2pDownloaded` | 从 Peer 获取的字节 |
|
|
226
|
+
| `p2pUploaded` | 向 Peer 分享的字节 |
|
|
227
|
+
| `connectedPeers` | 当前已连接 Peer 数量 |
|
|
228
|
+
| `downloadOffloadRatio` | P2P 下载字节 / HTTP 与 P2P 总下载字节,范围 0–1 |
|
|
229
|
+
|
|
230
|
+
百分比展示时将 `downloadOffloadRatio` 乘以 100;它是下载分流比例,不是上传分享比例。尚无下载数据时为零,不能仅凭有 Peer 或单次 CDN 回退判断分流效果。通过 `getDiagnostics()` 查看连接耗时和错误信息;可选字段可能为空。
|
|
231
|
+
|
|
232
|
+
<span id="接入验证" />
|
|
233
|
+
|
|
234
|
+
<details>
|
|
235
|
+
<summary>验证 P2P 效果</summary>
|
|
236
|
+
|
|
237
|
+
1. 先用单设备确认正常播放、点播拖动,以及关闭 P2P 后仍能播放。
|
|
238
|
+
2. 用两个设备播放同一内容,保持 `contentId` 一致;点播选择有重叠的播放进度,直播选择同一频道。媒体字节和时间轴应保持一致,不同资产或个性化清单不要复用同一个 ID。
|
|
239
|
+
3. 检查回传单位为毫秒,并在媒体清单加载后持续更新。当前位置 60 秒、连续缓冲到 70 秒时,缓冲值应为 10,000 毫秒;点播 Seek 完成后立即更新位置。
|
|
240
|
+
4. 在一段播放时间内观察 P2P 下载字节数与下载分担率的变化。仅有 Peer 连接不代表实际通过 P2P 下载了媒体;分片可用性、网络环境和平台策略都会影响结果。
|
|
241
|
+
5. 关闭 P2P,确认播放器继续通过 CDN 播放。随后停止状态回传并取消事件订阅,再关闭会话,确认切换内容后没有继续调用已关闭的会话。
|
|
242
|
+
|
|
243
|
+
</details>
|
|
244
|
+
|
|
245
|
+
## 网络与平台策略
|
|
246
|
+
|
|
247
|
+
Wi-Fi、蜂窝网络、以太网、账户权限与额度由原生 SDK 和控制台策略共同判断,本地 P2P 开关不能覆盖服务端限制。不要向客户端传入 `region`、`areaCode` 或 Tracker/ICE 地址。通过 `getStatus()` 查看 `effectiveP2pEnabled` 与 `reason`;单纯 Peer 数为零不代表播放异常。
|
|
248
|
+
|
|
249
|
+
SDK 播放地址使用 HTTP 回环代理,即使媒体源是 HTTPS 也需要完成 [Android/iOS 网络配置](./flutter-setup.md),并确保 Release 包同样生效。已有网络策略时合并必要例外;公网 HTTP 媒体源仅放行所需域名,优先使用 HTTPS。
|
|
250
|
+
|
|
251
|
+
## 生命周期与后台播放
|
|
252
|
+
|
|
253
|
+
<span id="生命周期顺序" />
|
|
254
|
+
|
|
255
|
+
切换内容或销毁播放页面时:
|
|
256
|
+
|
|
257
|
+
1. 停止状态回传,等待在途回传结束,并取消事件订阅。
|
|
258
|
+
2. 停止播放器并解除当前媒体引用。
|
|
259
|
+
3. 关闭当前 session 及不再需要的预加载候选会话。
|
|
260
|
+
4. 只有其他活动会话都不再需要 client 时,才关闭 client。
|
|
261
|
+
|
|
262
|
+
后台或画中画仍在播放时,保留对应播放器和会话,由宿主应用配置后台模式、音频会话与播放器能力。页面离开是否释放资源需遵循业务播放策略,不能直接关闭仍在后台播放的会话。SDK 不绕过操作系统限制,也不保证后台持续分享。
|
|
263
|
+
|
|
264
|
+
```dart
|
|
265
|
+
await session.close();
|
|
266
|
+
await client.close();
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
## 能力边界
|
|
270
|
+
|
|
271
|
+
以下为当前 Flutter 封装的公共 API 范围;以本页公开参数为准,不要直接传入仅原生 SDK 支持的字段:
|
|
272
|
+
|
|
273
|
+
| 能力 | 当前封装入口 |
|
|
274
|
+
| --- | --- |
|
|
275
|
+
| HLS / DASH / MP4 / MP3、源站请求头、稳定内容标识 | 通过会话参数使用 |
|
|
276
|
+
| 多会话、预加载、P2P 开关、状态回传、统计 | 使用本页对应方法 |
|
|
277
|
+
| `maxMemoryBytes`、Peer 连接上限、请求超时、原生日志级别 | 当前未开放对应公共配置项 |
|
|
278
|
+
| Apple `setPictureInPictureActive` | 当前未开放对应桥接方法;播放器支持画中画不等于封装已提供此接口 |
|
|
279
|
+
| 解码、ABR、DRM、播放器缓存、系统后台权限 | 由播放器与应用管理 |
|
|
280
|
+
|
|
281
|
+
P2P 不可用不等于媒体不可播放。会话有效时继续使用其播放地址,是否重试或终止由播放器错误及源站响应决定;原生初始化或桥接调用失败仍需由应用处理。
|
|
282
|
+
|
|
283
|
+
## 相关文档
|
|
284
|
+
|
|
285
|
+
[安装与配置](./flutter-setup.md) · [快速接入](./flutter.md) · [故障排查](../troubleshooting.md)
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Flutter SDK 安装与配置
|
|
3
|
+
sidebar_label: 安装与配置
|
|
4
|
+
description: "Flutter SDK 安装与配置指南:平台要求、依赖安装和应用设置。"
|
|
5
|
+
pagination_label: "Flutter SDK 安装与配置"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Flutter SDK 安装与配置
|
|
9
|
+
|
|
10
|
+
当前插件版本为 `meshstream_p2p 1.0.9`,发布于 [pub.dev](https://pub.dev/packages/meshstream_p2p/versions/1.0.9)。插件把原生 SDK 的播放地址和状态交给 Flutter 播放器,不提供播放器界面或解码器。
|
|
11
|
+
|
|
12
|
+
## 接入准备
|
|
13
|
+
|
|
14
|
+
- Flutter 3.22+、Dart 3.4+;
|
|
15
|
+
- 控制台创建的 Flutter 应用 SDK Key;
|
|
16
|
+
- 一个可播放的 HLS `.m3u8`、DASH `.mpd`、支持 Range 的 MP4 或 MP3 地址;
|
|
17
|
+
- 一个 Flutter 播放器,例如 `video_player`。
|
|
18
|
+
|
|
19
|
+
插件 Android 声明下限为 API 21,iOS 为 15.0。应用实际下限取插件、Flutter 引擎、播放器和其他依赖的最高要求;当前示例使用 Android API 24。插件固定使用公开 Android SDK `io.meshstream:meshstream-android-sdk:1.0.10` 和 iOS `MeshStreamKit 1.0.10`。
|
|
20
|
+
|
|
21
|
+
Android 原生依赖包含 `armeabi-v7a`、`arm64-v8a`、`x86`、`x86_64` 四种 ABI。真机与模拟器需同时满足框架和播放器的系统及架构要求。
|
|
22
|
+
|
|
23
|
+
Flutter 的 Android 模拟器调试请使用当前 Flutter 版本支持的 arm64 或 x86_64 系统镜像。
|
|
24
|
+
|
|
25
|
+
Android 权限与编译要求见[原生工程配置](./android-setup.md#工程配置),R8 和缓存预算见[混淆与内存](./android-setup.md#混淆与内存)。保留 Flutter 工程要求的 Java/Kotlin 编译目标。
|
|
26
|
+
|
|
27
|
+
## 安装
|
|
28
|
+
|
|
29
|
+
```yaml
|
|
30
|
+
dependencies:
|
|
31
|
+
meshstream_p2p: 1.0.9
|
|
32
|
+
video_player: ^2.9.3
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
根据工程当前的仓库管理方式选择下面一种配置。以下示例使用 Kotlin DSL。
|
|
36
|
+
|
|
37
|
+
### Flutter 默认工程
|
|
38
|
+
|
|
39
|
+
在 `android/build.gradle.kts` 已有的 `allprojects.repositories` 中添加 MeshStream 仓库,保留原有仓库:
|
|
40
|
+
|
|
41
|
+
```kotlin
|
|
42
|
+
allprojects {
|
|
43
|
+
repositories {
|
|
44
|
+
google()
|
|
45
|
+
mavenCentral()
|
|
46
|
+
maven {
|
|
47
|
+
url = uri("https://sdk.meshstream.net/maven")
|
|
48
|
+
content { includeGroup("io.meshstream") }
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### 使用 settings 集中管理仓库的工程
|
|
55
|
+
|
|
56
|
+
在 `android/settings.gradle.kts` 的 `dependencyResolutionManagement` 中合并下面的配置。显式设置 `PREFER_SETTINGS`,让 settings 中的仓库生效;同时保留 Google、Maven Central、Flutter 引擎及业务所需的仓库:
|
|
57
|
+
|
|
58
|
+
```kotlin
|
|
59
|
+
dependencyResolutionManagement {
|
|
60
|
+
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
|
|
61
|
+
repositories {
|
|
62
|
+
google()
|
|
63
|
+
mavenCentral()
|
|
64
|
+
maven {
|
|
65
|
+
val flutterStorageBaseUrl =
|
|
66
|
+
System.getenv("FLUTTER_STORAGE_BASE_URL") ?: "https://storage.googleapis.com"
|
|
67
|
+
url = uri("$flutterStorageBaseUrl/download.flutter.io")
|
|
68
|
+
content { includeGroup("io.flutter") }
|
|
69
|
+
}
|
|
70
|
+
maven {
|
|
71
|
+
url = uri("https://sdk.meshstream.net/maven")
|
|
72
|
+
content { includeGroup("io.meshstream") }
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
执行 `flutter pub get`,iOS 工程再执行 `cd ios && pod install`。插件会从公开渠道解析对应的原生依赖。
|
|
79
|
+
|
|
80
|
+
## 平台网络配置
|
|
81
|
+
|
|
82
|
+
### Android
|
|
83
|
+
|
|
84
|
+
SDK 返回的播放地址使用本机 HTTP 回环代理,即使媒体源是 HTTPS,也需要允许播放器访问该代理。
|
|
85
|
+
|
|
86
|
+
在 `android/app/src/main/AndroidManifest.xml` 的 `<application>` 中添加:
|
|
87
|
+
|
|
88
|
+
```xml
|
|
89
|
+
android:networkSecurityConfig="@xml/meshstream_network_security_config"
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
创建 `android/app/src/main/res/xml/meshstream_network_security_config.xml`:
|
|
93
|
+
|
|
94
|
+
```xml
|
|
95
|
+
<?xml version="1.0" encoding="utf-8"?>
|
|
96
|
+
<network-security-config>
|
|
97
|
+
<base-config cleartextTrafficPermitted="false" />
|
|
98
|
+
<domain-config cleartextTrafficPermitted="true">
|
|
99
|
+
<domain includeSubdomains="false">127.0.0.1</domain>
|
|
100
|
+
<domain includeSubdomains="false">localhost</domain>
|
|
101
|
+
</domain-config>
|
|
102
|
+
</network-security-config>
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
将配置放在 `src/main`,使 Debug 和 Release 均生效。已有网络安全策略时合并回环地址规则,保留原有配置。公网 HTTP 媒体源需另行添加对应域名规则,建议优先使用 HTTPS。需要兼容 Android 6.0(API 23)的应用,请同时参照 [Android 网络配置](./android-setup.md#允许本地播放代理) 设置该系统的明文访问策略。
|
|
106
|
+
|
|
107
|
+
### iOS
|
|
108
|
+
|
|
109
|
+
在 `ios/Runner/Info.plist` 的 `NSAppTransportSecurity` 字典中添加本地网络许可;已有该字典时合并配置:
|
|
110
|
+
|
|
111
|
+
```xml
|
|
112
|
+
<key>NSAppTransportSecurity</key>
|
|
113
|
+
<dict>
|
|
114
|
+
<key>NSAllowsLocalNetworking</key>
|
|
115
|
+
<true/>
|
|
116
|
+
</dict>
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
保留其他 ATS 限制;媒体源需要额外例外时只添加必要规则。
|
|
120
|
+
|
|
121
|
+
## 下一步
|
|
122
|
+
|
|
123
|
+
完成以上配置后,进入[快速接入](./flutter.md),创建会话、连接播放器,并在播放结束后释放资源。
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Flutter SDK 快速接入
|
|
3
|
+
sidebar_label: 快速接入
|
|
4
|
+
description: "Flutter SDK 快速接入指南:创建播放会话、连接播放器、查看状态并释放资源。"
|
|
5
|
+
pagination_label: "Flutter SDK 快速接入"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Flutter SDK 快速接入
|
|
9
|
+
|
|
10
|
+
当前插件版本为 `meshstream_p2p 1.0.9`,发布于 [pub.dev](https://pub.dev/packages/meshstream_p2p/versions/1.0.9)。插件把原生 SDK 的播放地址和状态交给 Flutter 播放器,不提供播放器界面或解码器。
|
|
11
|
+
|
|
12
|
+
<span id="接入准备" />
|
|
13
|
+
<span id="安装" />
|
|
14
|
+
<span id="flutter-默认工程" />
|
|
15
|
+
<span id="使用-settings-集中管理仓库的工程" />
|
|
16
|
+
<span id="平台网络配置" />
|
|
17
|
+
<span id="android" />
|
|
18
|
+
<span id="ios" />
|
|
19
|
+
|
|
20
|
+
运行代码前,请先完成[安装与配置](./flutter-setup.md),准备 SDK Key 和可播放媒体地址,并配置应用网络策略。
|
|
21
|
+
|
|
22
|
+
## 最小接入
|
|
23
|
+
|
|
24
|
+
```dart
|
|
25
|
+
import 'package:meshstream_p2p/meshstream_p2p.dart';
|
|
26
|
+
import 'package:video_player/video_player.dart';
|
|
27
|
+
|
|
28
|
+
final client = await MeshStream.create(
|
|
29
|
+
MeshStreamConfig(key: 'your_sdk_key'),
|
|
30
|
+
);
|
|
31
|
+
final session = await client.createPlaybackSession(
|
|
32
|
+
PlaybackSessionOptions(
|
|
33
|
+
url: 'https://cdn.example.com/live/playlist.m3u8',
|
|
34
|
+
contentId: 'live-channel-42',
|
|
35
|
+
mimeType: MeshStreamMimeType.m3u8,
|
|
36
|
+
),
|
|
37
|
+
);
|
|
38
|
+
final controller = VideoPlayerController.networkUrl(
|
|
39
|
+
Uri.parse(session.playbackUrl),
|
|
40
|
+
);
|
|
41
|
+
await controller.initialize();
|
|
42
|
+
await controller.play();
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
播放结束时先释放播放器,再关闭会话和客户端:
|
|
46
|
+
|
|
47
|
+
```dart
|
|
48
|
+
await controller.dispose();
|
|
49
|
+
await session.close();
|
|
50
|
+
await client.close();
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
P2P 暂不可用时仍会使用会话的播放地址通过 CDN 播放。可使用 `session.getStats()`、`session.getDiagnostics()` 和 `client.getStatus()` 查看状态;不要因为 P2P 不可用而停止播放器。
|
|
54
|
+
|
|
55
|
+
## 运行官方示例
|
|
56
|
+
|
|
57
|
+
从 [Flutter SDK 仓库](https://github.com/Mesh-Stream/meshstream-p2p-flutter-sdk)获取示例,在 `example` 目录运行:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
flutter pub get
|
|
61
|
+
flutter devices
|
|
62
|
+
flutter run --target lib/main.dart
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
连接多个设备时添加 `-d 设备ID`。页面打开后输入控制台创建的 SDK Key 和可播放的媒体地址,点击 **Create session**,即可查看画面及 P2P/CDN 统计。输入框中的提示值需要替换为自己的有效信息。
|
|
66
|
+
|
|
67
|
+
### Android 独立运行与 APK
|
|
68
|
+
|
|
69
|
+
需要在脱离开发工具后使用 Demo,可在 `example` 目录构建并启动 Release 版本;将 `YOUR_ANDROID_DEVICE_ID` 替换为 `flutter devices` 显示的设备 ID:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
flutter run --release --target lib/main.dart -d YOUR_ANDROID_DEVICE_ID
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
需要分发 APK 时执行:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
flutter build apk --release --target lib/main.dart
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
APK 位于 `build/app/outputs/flutter-apk/app-release.apk`。发布自己的应用前,按 Flutter 的 Android 发布流程配置应用 ID、版本及正式签名。
|
|
82
|
+
|
|
83
|
+
## 预加载与生命周期
|
|
84
|
+
|
|
85
|
+
列表场景可以为下一条内容创建独立会话并调用 `await session.preload()`,真正播放时复用该会话。候选内容取消时调用 `session.close()`;播放页面销毁时取消事件订阅并释放播放器、会话和客户端。
|
|
86
|
+
|
|
87
|
+
## 版本与验证
|
|
88
|
+
|
|
89
|
+
Flutter 包版本独立于原生 SDK 版本。遇到问题时同时记录 `meshstream_p2p` 版本、原生 Android/iOS SDK 版本、平台和播放器版本。示例与发布记录见 [Flutter SDK GitHub 仓库](https://github.com/Mesh-Stream/meshstream-p2p-flutter-sdk)。
|
|
90
|
+
|
|
91
|
+
相关文档:[安装与配置](./flutter-setup.md) · [高级用法](./flutter-advanced.md)。
|