@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
package/content/intro.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
---
|
|
2
|
+
sidebar_position: 1
|
|
3
|
+
title: 简介
|
|
4
|
+
description: 面向 Web、Android、iOS 与 Windows 播放场景的 P2P 媒体加速平台。
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 简介
|
|
8
|
+
|
|
9
|
+
MeshStream 是面向视频、直播和音频业务的 P2P 媒体加速平台。它以 SDK 的形式接入现有播放链路,在不替换播放器、源站和 CDN 的前提下,为可复用的媒体分片提供额外的传输路径。
|
|
10
|
+
|
|
11
|
+
## 产品定位
|
|
12
|
+
|
|
13
|
+
热点内容会在短时间内产生大量相同的媒体请求。MeshStream 允许符合策略和网络条件的观看设备复用已获取的媒体分片,从而降低热点内容对 CDN 带宽的集中压力。P2P 是可控的增强路径,CDN 始终保留为稳定的播放路径。
|
|
14
|
+
|
|
15
|
+
MeshStream 不改变业务应用对播放器、源站、DRM 或 CDN 的既有所有权和控制边界:播放器继续负责清单解析、ABR、解码和渲染;源站继续负责媒体授权;CDN 继续提供完整的可用性保障。
|
|
16
|
+
|
|
17
|
+
## 播放会话模型
|
|
18
|
+
|
|
19
|
+

|
|
20
|
+
|
|
21
|
+
每次播放都应创建一个独立的会话,标准流程如下:
|
|
22
|
+
|
|
23
|
+
1. 业务应用将原始媒体地址和 SDK Key 交给 SDK;
|
|
24
|
+
2. SDK 创建播放会话,并返回本次会话对应的播放地址;
|
|
25
|
+
3. 业务播放器加载 SDK 返回的播放地址,继续执行原有播放流程;
|
|
26
|
+
4. 会话结束、切换内容或页面销毁时,业务应用释放该会话。
|
|
27
|
+
|
|
28
|
+
SDK 会根据内容标识、网络条件和服务策略选择可用的传输路径。加速能力暂不可用时,播放器仍可通过原有 CDN 路径继续播放。
|
|
29
|
+
|
|
30
|
+
## 接入边界
|
|
31
|
+
|
|
32
|
+
- **播放器保持不变**:SDK 不接管 ABR、解码、渲染或 DRM。播放器必须继续支持业务使用的媒体格式。
|
|
33
|
+
- **跨平台统一**:同一应用可接入 Web、Android、iOS 和 Windows SDK,使用统一的 Key、内容标识和统计口径。
|
|
34
|
+
- **媒体格式**:HLS 和 DASH 由业务播放器负责解析;MP4、MP3 直链是否启用加速,取决于平台能力、Service Worker(Web)和源站 Range 支持。
|
|
35
|
+
- **鉴权责任清晰**:签名 URL、Cookie、Authorization、源站请求头和 DRM 仍由业务方的媒体服务负责。源站凭证不会发送给其他观看设备。
|
|
36
|
+
- **故障隔离**:配置、网络或加速连接异常不应阻断播放器。业务代码不应把“加速不可用”当作“媒体不可播放”处理。
|
|
37
|
+
|
|
38
|
+
## 统计与用量
|
|
39
|
+
|
|
40
|
+
SDK 在播放过程中异步记录会话状态、P2P 传输、CDN 传输、Peer 数量和异常原因,并在控制台按应用、Key、平台和内容维度聚合展示。
|
|
41
|
+
|
|
42
|
+
MeshStream 的额度仅按实际产生的 P2P 下载流量计算。未命中 P2P 时,播放仍可使用业务方 CDN;相关 CDN 传输数据用于效果分析和故障诊断,不计入 MeshStream 的 P2P 额度。
|
|
43
|
+
|
|
44
|
+
## 适用场景
|
|
45
|
+
|
|
46
|
+
- 直播、点播、赛事和大型活动等具有明显重复观看特征的内容;
|
|
47
|
+
- 需要降低热点内容 CDN 峰值带宽或缓解源站压力的业务;
|
|
48
|
+
- 希望在保留现有播放器和 CDN 的基础上,以灰度方式引入 P2P 能力的团队。
|
|
49
|
+
|
|
50
|
+
## 推荐阅读顺序
|
|
51
|
+
|
|
52
|
+
1. [快速开始](./quickstart.md):创建 Key,完成一次最小接入并验证播放链路;
|
|
53
|
+
2. [选择 SDK](./sdk/overview.md):按平台进入“安装与配置 → 快速接入 → 高级用法”;
|
|
54
|
+
3. [核心概念](./concepts/p2p.md) 与 [最佳实践](./best-practices.md):了解内容标识、会话生命周期和上线验收要求。
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: privacy
|
|
3
|
+
title: MeshStream 隐私协议
|
|
4
|
+
sidebar_label: 隐私协议
|
|
5
|
+
description: MeshStream 开发者平台、SDK 和 P2P 服务的隐私协议
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# MeshStream 隐私协议
|
|
9
|
+
|
|
10
|
+
生效日期:2026 年 10 月 11 日
|
|
11
|
+
|
|
12
|
+
本隐私协议说明 MeshStream 在您注册、使用控制台、接入 SDK、运行 Web Demo 或使用相关服务时,如何收集、使用、保存、共享和保护信息。我们只处理提供服务、保障安全、计量结算和履行法律义务所需的信息。
|
|
13
|
+
|
|
14
|
+
MeshStream 是由个人运营者提供的品牌和服务名称,目前不代表已设立的公司、法人或独立法律实体。运营主体、正式服务通知地址、适用法律和争议解决地以本协议当前版本、订单或法律通知中公布的信息为准。对于您通过 SDK 或服务处理的终端用户个人信息,您通常是决定处理目的和方式的责任方,MeshStream 按您的指示提供受托技术处理。您应自行向终端用户提供符合法律要求的隐私告知并取得必要授权;本协议不替代您面向终端用户的隐私政策。
|
|
15
|
+
|
|
16
|
+
## 一、我们处理的信息
|
|
17
|
+
|
|
18
|
+
### 1. 账号与联系信息
|
|
19
|
+
|
|
20
|
+
包括邮箱地址、密码哈希、邮箱验证状态、注册区域、账号状态、登录时间和必要的安全审计记录。我们不会保存您的明文密码。
|
|
21
|
+
|
|
22
|
+
### 2. 应用与配置数据
|
|
23
|
+
|
|
24
|
+
包括应用名称、App ID、SDK Key 的标识信息、播放域名、区域策略、Tracker 和回源配置、白名单及控制台操作记录。Key 的秘密部分不应出现在客户端日志、公开代码或媒体 URL 中。
|
|
25
|
+
|
|
26
|
+
### 3. SDK 与设备运行信息
|
|
27
|
+
|
|
28
|
+
在您接入 SDK 并播放内容时,可能处理 SDK 版本、平台、操作系统、浏览器或播放器类型、匿名设备标识、应用版本、网络类型、区域、Peer 能力、连接状态和错误原因。此类信息用于调度、兼容性判断、故障诊断和安全防护。
|
|
29
|
+
|
|
30
|
+
### 4. 播放与用量信息
|
|
31
|
+
|
|
32
|
+
包括应用、会话、内容标识、媒体协议、分片请求结果、P2P 下载量、CDN 回源量、命中情况、播放鉴权结果、延迟、失败和降级原因。我们通常不需要保存媒体正文;如为处理安全事件、技术问题或法律义务需要保存相关日志,会采取必要的访问控制和期限限制。
|
|
33
|
+
|
|
34
|
+
### 5. 交易与客户支持信息
|
|
35
|
+
|
|
36
|
+
包括套餐、额度、订单、账单状态、工单、反馈和您主动提供的排障材料。当前未接入在线支付的环境不会由 MeshStream 保存完整银行卡或支付账户信息。
|
|
37
|
+
|
|
38
|
+
## 二、我们如何使用信息
|
|
39
|
+
|
|
40
|
+
我们使用上述信息来:
|
|
41
|
+
|
|
42
|
+
- 创建和保护账号,发送验证、重置和服务通知;
|
|
43
|
+
- 提供 P2P 调度、CDN 回源、会话管理、跨端兼容和播放降级;
|
|
44
|
+
- 计算套餐、每日额度、加油包和其他用量;
|
|
45
|
+
- 生成控制台统计、诊断报告、告警和验收证据;
|
|
46
|
+
- 检测滥用、攻击、盗用 Key、异常流量和违反协议的行为;
|
|
47
|
+
- 修复故障、改进 SDK 与服务质量,并履行法律、监管和争议处理义务。
|
|
48
|
+
- 识别关联账号、阻止额度滥用、保护 MeshStream、客户及其他用户的安全。
|
|
49
|
+
|
|
50
|
+
我们不会将您的媒体内容、源站凭证或业务数据出售给第三方,也不会使用客户内容制作与客户无关的广告画像。
|
|
51
|
+
|
|
52
|
+
## 三、P2P 场景下的隐私边界
|
|
53
|
+
|
|
54
|
+
P2P 连接需要在参与节点之间交换完成连接和分片传输所必需的网络元数据,例如临时 Peer 标识、连接状态和分片请求信息。SDK 不应将源站鉴权头、源站密码、客户私有 Token 或其他敏感请求头发送给 Peer;源站请求应继续由客户自己的 CDN、源站或受控回源链路处理。
|
|
55
|
+
|
|
56
|
+
MeshStream 会尽量使用匿名或短期标识,并根据调度、风控和统计需要保留必要的连接记录。您应在自己的隐私政策和产品提示中向终端用户说明 P2P 连接、网络元数据和本地缓存行为,并在需要时取得授权。
|
|
57
|
+
|
|
58
|
+
## 四、Cookies 与本地存储
|
|
59
|
+
|
|
60
|
+
控制台可能使用浏览器本地存储、会话 Cookie 或类似技术保存登录状态、语言、主题和安全令牌。SDK 可能使用本地缓存保存临时分片、会话状态和性能信息。您可以通过浏览器或系统设置清理这些数据,但可能导致退出登录、缓存失效或播放体验下降。
|
|
61
|
+
|
|
62
|
+
如果官网启用 Google Analytics,Google 标签会在默认拒绝分析存储的 Consent Mode 下加载;在您通过 Cookie 偏好弹窗明确允许分析前,不会设置或读取分析 Cookie,仅可能向 Google 发送不含分析 Cookie 的测量信号。获得您的许可后,我们才会启用基于 Cookie 的分析,用于了解页面使用情况和改进文档与产品导航。您可以在首次访问时拒绝,也可以通过页脚“法律与合规”中的“Cookie 偏好”入口撤回同意。Google 可能按照其自身的服务条款和隐私政策处理相关测量数据。
|
|
63
|
+
|
|
64
|
+
## 五、共享、委托与跨区域处理
|
|
65
|
+
|
|
66
|
+
为提供服务,我们可能向受约束的基础设施、邮件、日志、监控、云存储和客户支持服务商提供必要的信息。服务商只能按照我们的指示处理信息,并应承担保密和安全义务。
|
|
67
|
+
|
|
68
|
+
这些服务商属于基础设施、邮件发送、日志监控、客服和安全风控等类别。我们会通过合同、权限控制、最小化、加密或其他合理措施约束其处理行为;服务商发生变化时,我们会在适用法律要求的范围内更新相关说明。
|
|
69
|
+
|
|
70
|
+
您选择的服务区域可能涉及跨区域调度、日志处理或灾备。跨境处理时,我们会根据适用法律采取合同、访问控制、加密、最小化和其他必要措施。除法律要求、保护用户和平台安全或经您授权外,我们不会向无关第三方披露您的信息。
|
|
71
|
+
|
|
72
|
+
如监管、司法或其他有权机关依法要求提供信息,我们会在法律允许的范围内通知您并仅披露必要范围;如通知会妨碍调查、危及安全或法律禁止通知,我们可以不予通知。
|
|
73
|
+
|
|
74
|
+
## 六、保存期限
|
|
75
|
+
|
|
76
|
+
我们按实现业务目的所需的最短期限保存信息:账号信息在账号存续期间保存;安全、审计、用量和结算记录可能在账号终止后继续保存一段合理期限;法律、争议、安全事件或备份要求可能延长保存期限。超过期限后,我们会删除、匿名化或安全隔离相关信息。
|
|
77
|
+
|
|
78
|
+
发生安全事件、争议、欠费、投诉或法律调查时,相关日志和证据可能在必要期限内继续保存。账号终止后的数据导出、删除及备份处理以《用户服务协议》约定为准。
|
|
79
|
+
|
|
80
|
+
## 七、您的权利
|
|
81
|
+
|
|
82
|
+
在适用法律允许的范围内,您可以请求访问、更正、删除账号信息,撤回特定授权,限制或反对部分处理,并获取与您有关的可携带数据。删除账号可能影响未结算订单、审计记录、争议处理和法律留存义务。
|
|
83
|
+
|
|
84
|
+
您可以通过 `support@meshstream.net` 联系我们。为保护账号安全,我们可能要求您完成身份验证后再处理请求,并在法律规定的期限内回复。
|
|
85
|
+
|
|
86
|
+
## 八、安全措施
|
|
87
|
+
|
|
88
|
+
我们采用密码哈希、传输加密、凭证隔离、权限控制、访问审计、速率限制、备份和安全监控等措施保护信息。没有任何互联网传输或存储方式能够保证绝对安全,您也应负责保护密码、SDK Key、源站凭证和控制台访问设备。
|
|
89
|
+
|
|
90
|
+
如发生可能影响您信息安全的事件,我们会按照适用法律采取补救措施,并在法律要求或合理必要的范围内通过控制台、注册邮箱或其他方式通知您。
|
|
91
|
+
|
|
92
|
+
## 九、未成年人
|
|
93
|
+
|
|
94
|
+
服务主要面向开发者和企业用户。未成年人使用服务应获得其监护人或所在组织的合法授权。若您发现未成年人在未获适当授权的情况下向我们提供个人信息,请通过 `support@meshstream.net` 联系我们。
|
|
95
|
+
|
|
96
|
+
## 十、协议更新与联系我们
|
|
97
|
+
|
|
98
|
+
我们会根据服务、法律或安全要求更新本协议,并在官网公布新的生效日期。重大变化会通过控制台、注册邮箱或其他合理方式通知。
|
|
99
|
+
|
|
100
|
+
隐私请求、数据主体权利、安全事件和其他隐私问题:`support@meshstream.net`
|
|
101
|
+
|
|
102
|
+
## 十一、新加坡区域与个人信息保护
|
|
103
|
+
|
|
104
|
+
如控制台或订单标示已启用新加坡区域,选择该区域的账号、租户、应用配置、订单、额度、用量和安全审计数据原则上由新加坡区域的控制面处理和保存;为提供全球接入、故障恢复、邮件发送、支付、监控或客户支持,必要信息仍可能由其他地区的受约束服务商处理。未标示启用的区域不构成数据存储位置或可用性承诺。
|
|
105
|
+
|
|
106
|
+
对于适用新加坡《个人资料保护法》(PDPA)的个人信息,我们会按照适用法律履行收集、使用、披露、保护、保存和删除义务,并采取访问控制、加密、最小化、审计和供应商管理等措施。跨境传输仅限于提供服务、履行法律义务或保护安全所必需的范围,并采取适用法律要求的保护措施。
|
|
107
|
+
|
|
108
|
+
如您代表客户使用 MeshStream 处理终端用户信息,您通常负责确定处理目的和合法依据、向终端用户提供告知、取得必要同意并响应其请求;MeshStream 按您的书面指示提供受托处理。发生可能影响个人信息安全的事件时,我们会在合理可行范围内及时通知受影响客户并配合调查、补救和法定通报。
|
|
109
|
+
|
|
110
|
+
区域数据保存位置、服务商清单、保存期限和隐私联系人可能随服务架构变化而更新;最新信息以本协议、控制台、订单和相关法律通知为准。
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: terms
|
|
3
|
+
title: MeshStream 用户服务协议
|
|
4
|
+
sidebar_label: 用户服务协议
|
|
5
|
+
description: MeshStream 开发者平台及 SDK 服务的用户服务协议
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# MeshStream 用户服务协议
|
|
9
|
+
|
|
10
|
+
生效日期:2026 年 10 月 11 日
|
|
11
|
+
|
|
12
|
+
欢迎使用 MeshStream 开发者平台、控制台、SDK、在线 Demo 及相关服务(以下统称“服务”)。MeshStream 是由个人运营者提供的品牌和服务名称,目前不代表已设立的公司、法人或独立法律实体。本协议由个人运营者以 MeshStream 品牌与注册、访问或使用服务的个人、企业或其他组织(以下简称“您”)订立。
|
|
13
|
+
|
|
14
|
+
注册账号、勾选同意、访问控制台或以其他方式使用服务,即表示您已阅读、理解并同意本协议及《MeshStream 隐私协议》。如果您代表企业或其他组织使用服务,您确认自己已获得必要授权,并代表该组织接受本协议。
|
|
15
|
+
|
|
16
|
+
本协议与购买页面、订单、技术文档、服务规则及双方另行签署的书面协议共同构成您与 MeshStream 之间的完整约定。文件内容不一致时,双方另行签署的书面协议优先;其后依次以订单或购买页面、专项服务规则、技术文档和本协议为准。运营主体、正式服务通知地址、适用法律和争议解决地以本协议当前版本、订单或法律通知中公布的信息为准。
|
|
17
|
+
|
|
18
|
+
## 一、服务范围
|
|
19
|
+
|
|
20
|
+
MeshStream 为媒体内容提供请求层的分发与加速能力,包括:
|
|
21
|
+
|
|
22
|
+
- 跨端 SDK、接口和控制台,用于创建应用、配置 Key、管理播放会话和查看数据;
|
|
23
|
+
- 基于 P2P 的分片分享、Peer 调度、缓存和连接管理;
|
|
24
|
+
- P2P 不可用时的客户 CDN 回源路径;
|
|
25
|
+
- 播放会话、流量、命中率、回源原因和异常等运行数据的统计与诊断;
|
|
26
|
+
- 套餐额度、每日额度、加油包和相关用量管理能力。
|
|
27
|
+
|
|
28
|
+
MeshStream 不接管您的播放器、ABR、DRM、解码、渲染、源站账号或媒体内容。具体能力以当前产品页面、技术文档和您所购买的套餐为准。
|
|
29
|
+
|
|
30
|
+
## 二、账号与区域
|
|
31
|
+
|
|
32
|
+
1. 您应提供真实、准确、完整且可持续使用的注册信息,并妥善保管账号、密码、SDK Key 和访问凭证。
|
|
33
|
+
2. 邮箱验证是账号启用的重要步骤。您不得使用无法控制的邮箱注册,也不得转让、出租、出借或共享账号及凭证。
|
|
34
|
+
3. 注册时选择的服务区域用于确定平台接入、数据处理和计费规则。区域选择可能影响可用套餐、数据路径和服务能力;具体以控制台展示为准。
|
|
35
|
+
4. 因您未及时更新信息、泄露凭证或授权他人操作造成的损失,由您承担责任。发现未经授权的使用时,应立即通过控制台或 `support@meshstream.net` 联系我们。
|
|
36
|
+
5. 为防止滥用、规避限制或重复领取权益,我们可以根据注册信息、设备、网络、支付、使用行为及其他安全信号识别关联账号,并对关联账号统一计算额度、采取风控措施或限制服务。我们不会仅因正常的企业内部账号管理而无故限制服务。
|
|
37
|
+
|
|
38
|
+
## 三、使用要求
|
|
39
|
+
|
|
40
|
+
您只能将服务用于合法、正当的业务,不得:
|
|
41
|
+
|
|
42
|
+
- 发布、分发或传播违法内容、侵权内容、恶意软件或未经授权的媒体资源,包括赌博、博彩、色情淫秽、性交易、涉毒、暴力恐怖、诈骗、传销、仇恨煽动及其他违反适用法律、行政法规或公共秩序的内容;
|
|
43
|
+
- 利用 P2P、回源或 SDK 实施攻击、扫描、刷量、欺诈、绕过访问控制或干扰他人服务;
|
|
44
|
+
- 通过伪造播放请求、设备身份、用量报告或回源信息获取额度、数据或其他不当利益;
|
|
45
|
+
- 将 SDK、Key、接口凭证或 Peer 能力提供给未授权的第三方,或用于搭建开放代理、下载器或内容盗链服务;
|
|
46
|
+
- 反向工程、篡改、破解、规避服务的安全机制,或删除产品中的权利声明;
|
|
47
|
+
- 以超出套餐、区域、速率或技术文档约定的方式使用服务。
|
|
48
|
+
|
|
49
|
+
您应确保已取得处理、存储、分发媒体内容和相关终端数据所需的全部授权,并负责向您的用户履行必要的告知与授权义务。
|
|
50
|
+
|
|
51
|
+
您还应自行取得开展业务所需的许可、备案、版权、内容审核和行业资质,确保您的产品、网站和用户行为符合适用法律。因您的内容、业务、用户或未取得必要授权引发第三方投诉、索赔、行政处罚或司法程序的,您应负责处理并赔偿 MeshStream 因此遭受的损失及合理的律师费、调查取证费和应诉费用。
|
|
52
|
+
|
|
53
|
+
如您的业务依法需要备案、许可或专项审批,您应在使用服务前自行完成并持续保持有效。您还应按照适用法律保存业务访问、内容发布、鉴权和安全事件记录,并在有权机关依法查询时自行配合。您不得通过配置无关程序、异常并发、刷量或其他方式大量占用 MeshStream 或其他用户的计算、存储和网络资源。
|
|
54
|
+
|
|
55
|
+
## 四、双方权利与义务
|
|
56
|
+
|
|
57
|
+
### 1. 您的权利
|
|
58
|
+
|
|
59
|
+
- 按照本协议、购买页面和技术文档使用已开通的服务,并查看与账号、应用、用量和订单相关的信息;
|
|
60
|
+
- 在服务范围内获得文档、接口和合理的技术支持;
|
|
61
|
+
- 在适用法律和本协议约定的范围内,通过指定渠道申请管理、导出或删除您的业务数据,并就计量、服务质量和安全事件向我们提出异议或反馈;
|
|
62
|
+
- 对服务变更、账号限制和数据处理提出咨询,我们将在合理范围内提供说明;
|
|
63
|
+
- 在非紧急安全或监管处置情况下,可以通过指定渠道提交账号限制、停用或终止的复核申请或补充材料,我们将在合理范围内处理;
|
|
64
|
+
- 对已生效订单按照购买时展示的价格、额度、有效期和计量规则使用服务,不因后续价格或规则调整而被追溯改变已完成订单。
|
|
65
|
+
|
|
66
|
+
### 2. 您对 MeshStream 的承诺
|
|
67
|
+
|
|
68
|
+
- 您承诺遵守本协议、购买页面、服务规则和技术文档,按时支付应付费用,并确保注册信息、联系人和授权信息真实、完整、有效;
|
|
69
|
+
- 您承诺自行负责产品、网站、播放器、源站、CDN、域名、鉴权、终端用户和内容运营,取得业务所需的许可、备案、版权及数据处理授权;
|
|
70
|
+
- 您承诺对通过服务传输、缓存、分发或处理的全部内容及数据承担合法性、真实性、准确性和完整性责任,不利用服务从事赌博、色情淫秽、诈骗、侵权、攻击或其他违法活动;
|
|
71
|
+
- 您承诺已向终端用户履行隐私告知、内容授权、P2P 连接和网络元数据处理等必要告知义务,并取得法律要求的授权;
|
|
72
|
+
- 您承诺妥善保管账号、密码、SDK Key、源站凭证和接口凭证,不转让、出租、出借、共享或允许未授权主体使用;
|
|
73
|
+
- 您承诺建立内容审核、信息安全和终端用户投诉处理机制,及时停止违法、侵权或危害网络安全的内容和行为;
|
|
74
|
+
- 您承诺按适用法律保存业务访问、内容发布、鉴权、计量和安全事件记录,并在发现凭证泄露、滥用或安全事件时立即通知我们并配合处置;
|
|
75
|
+
- 您承诺保持可用的源站、CDN、播放器和降级链路,不将 P2P 命中率、节省比例或服务连续性作为对 MeshStream 的单独履约保证;
|
|
76
|
+
- 您承诺不对 SDK、接口、服务或相关技术进行反向工程、反编译、破解、篡改、转售或用于开发与 MeshStream 竞争的基础设施服务;
|
|
77
|
+
- 如因您或您的用户、内容、产品、配置、授权或业务行为引发第三方投诉、索赔、处罚或诉讼,您承诺及时接管处理,使 MeshStream 免责并赔偿相关损失、费用和合理的律师费。
|
|
78
|
+
|
|
79
|
+
### 3. MeshStream 的权利
|
|
80
|
+
|
|
81
|
+
- 根据服务安全、容量、合规、技术演进和运营需要制定、调整和解释服务规则、技术规范、计量口径及风控策略;
|
|
82
|
+
- 对服务使用进行必要的安全检测、滥用识别、日志审计和故障诊断,并在发现违规、欠费、攻击、异常流量或监管风险时采取限制请求、停用 Key、删除配置、暂停或终止服务等措施;
|
|
83
|
+
- 在法律允许的范围内,为调查安全事件、处理投诉、履行监管或司法要求而保存、披露和使用必要信息;
|
|
84
|
+
- 使用匿名化、汇总化的运行数据分析服务质量、容量和产品表现,但不因此取得客户业务内容的所有权。
|
|
85
|
+
|
|
86
|
+
### 4. MeshStream 的义务
|
|
87
|
+
|
|
88
|
+
- 按已公布的服务范围和订单约定提供服务,并在合理可行范围内维护服务可用性、接口文档和控制台能力;
|
|
89
|
+
- 在适用法律和技术可行范围内,对客户业务数据和保密信息采取合理的访问控制、安全保护和保密措施,并按照《隐私协议》处理相关信息;
|
|
90
|
+
- 对计划中的重大服务变更、下线或影响客户使用的维护,在合理可行范围内提前通知;紧急安全处置、监管要求和不可抗力除外;
|
|
91
|
+
- 在收到有效的服务故障或安全事件反馈后,按照事件影响和服务等级在合理范围内提供排查、说明或协助;
|
|
92
|
+
- 在适用法律允许范围内,不出售客户媒体内容、源站凭证或业务数据,不将客户内容用于与客户无关的广告画像;
|
|
93
|
+
- 对服务端计量、额度扣减和订单状态保留合理的可追溯记录,并在确认属于 MeshStream 系统错误且技术可行时进行核查、更正或其他合理补救。
|
|
94
|
+
|
|
95
|
+
### 5. 服务说明与非保证
|
|
96
|
+
|
|
97
|
+
本协议对 P2P 调度、回源、计量、通知、支持和安全机制的描述,是当前服务能力和处理原则的说明,不构成服务等级协议、最低可用性、固定命中率、固定节省比例或特定业务结果保证。P2P 是可关闭、可降级的增强路径;具体可用性、服务等级、支持范围和补救方式以订单、专项服务规则和适用法律为准。
|
|
98
|
+
|
|
99
|
+
除本协议明确约定外,MeshStream 不负责客户产品的开发、运营、内容审核、版权取得、合规备案、播放器适配或源站运维。
|
|
100
|
+
|
|
101
|
+
## 五、P2P 与播放连续性
|
|
102
|
+
|
|
103
|
+
P2P 是可控的增强路径,不是播放服务的唯一依赖。由于终端能力、网络、Tracker、浏览器策略、内容分片、鉴权或其他因素,P2P 可能不可用、命中率下降或被平台策略关闭。发生异常时,SDK 会根据配置尝试回到您的 CDN 或其他已配置的播放路径。
|
|
104
|
+
|
|
105
|
+
MeshStream 尽力保障服务可用性,但不承诺每个请求都通过 P2P、达到特定命中率或节省固定比例的 CDN 流量。您仍应保持可用的 CDN、源站和播放器链路,并在上线前完成回源和降级验收。
|
|
106
|
+
|
|
107
|
+
## 六、额度、套餐与计费
|
|
108
|
+
|
|
109
|
+
1. 套餐额度、每日额度、有效期、加油包规则、区域和价格以购买页面及控制台订单信息为准。
|
|
110
|
+
2. 套餐通常按 30 天为一个周期;加油包的有效期和扣减顺序以购买时展示的规则为准。额度使用以 MeshStream 服务端记录为准。
|
|
111
|
+
3. P2P 下载量、回源量、上传量和其他计量项的定义,以产品文档和控制台统计口径为准。因客户端离线、网络重试、数据延迟或统计修正产生的差异,以最终结算数据为准。
|
|
112
|
+
4. 支付、退款、发票和税费规则以对应购买页面、结算流程和订单中展示或约定的内容为准;未明确展示或约定的,不视为已承诺相应的支付能力或商业条件。
|
|
113
|
+
5. 套餐、加油包和其他用量以 MeshStream 服务端计量系统的最终记录为准。您如对账单或用量有异议,应在相关记录生成之日起 30 日内提交具体证据;逾期未提出的,视为无异议,但确有系统错误或法律另有规定的除外。
|
|
114
|
+
6. 您应按订单或结算流程约定及时足额付款,并承担依法应由您承担的税费。逾期付款、拒付或发生异常退款时,我们可以暂停服务、停用 Key,并要求您承担合理的催收、调查和维权费用。
|
|
115
|
+
7. 除法律强制要求、订单明确约定或 MeshStream 书面同意外,已购买的额度、加油包和服务费用不兑换现金、不转让且不予退款。因我们主动下线相关服务的,退款或替代方案以当时公告和适用法律为准。
|
|
116
|
+
8. 我们可以因成本、产品、区域或法律变化调整价格、计量口径或服务规则,并按本协议约定通知。调整前已完成的订单不溯及既往,调整生效后继续使用服务视为接受新规则。
|
|
117
|
+
|
|
118
|
+
## 七、内容、数据与知识产权
|
|
119
|
+
|
|
120
|
+
您保留上传、配置或通过服务处理的内容及业务数据的权利,并授予 MeshStream 为提供、维护、保护和改进服务所必要的处理权限。该权限不构成对您内容的所有权转让。
|
|
121
|
+
|
|
122
|
+
MeshStream 的软件、SDK、接口、控制台、文档、商标、界面和服务实现受适用法律保护。除本协议明确授予的使用权外,您不得复制、出售、再许可或以其他方式使用 MeshStream 的知识产权。
|
|
123
|
+
|
|
124
|
+
在遵守本协议的前提下,我们授予您一项有限的、非独占的、不可转让且可撤销的许可,仅供您在服务有效期内将 SDK、接口和文档集成到您自有或合法运营的产品中。您不得转售、分许可、出租、共享 Key,或利用服务开发与 MeshStream 竞争的基础设施服务。您向我们提交的建议、反馈和错误报告可由我们用于改进产品,无需另行支付费用,但不影响您对自身业务数据的权利。
|
|
125
|
+
|
|
126
|
+
## 八、服务变更、限制与终止
|
|
127
|
+
|
|
128
|
+
我们可能基于安全、合规、容量、维护或产品演进调整、暂停或下线部分服务,并尽量提前通知。我们可以对服务使用情况进行必要的安全检测、审计和滥用调查。若您违反本协议、欠费、滥用服务、危及平台或他人安全,或收到有效的监管、司法或权利人通知,我们可以不经事先通知限制请求、删除或屏蔽相关配置、停用 Key、暂停账号或终止服务;紧急处置不影响我们依法保留证据和配合调查的权利。
|
|
129
|
+
|
|
130
|
+
因您严重违法、严重违约、欠费、实施攻击或给 MeshStream、其他用户或网络安全造成风险而暂停或终止服务的,已支付费用、未使用额度和优惠是否退还,以适用法律、订单约定及实际处置情况为准;MeshStream 无义务为因此产生的数据、业务或收益损失承担责任。
|
|
131
|
+
|
|
132
|
+
账号终止后,您应停止使用 SDK、Key 和接口。您可以在数据删除前通过 `support@meshstream.net` 提交数据导出申请,我们将在适用法律和技术可行范围内处理,并根据数据类型、结算状态和安全要求确认范围与期限。法律要求、争议处理、安全审计、备份或结算所需的数据可以继续保留。
|
|
133
|
+
|
|
134
|
+
## 九、免责声明与责任限制
|
|
135
|
+
|
|
136
|
+
服务按现状和可用状态提供。除法律强制要求外,我们不保证服务持续不中断、完全无错误、永久提供某一功能、适用于您的特定业务,或 P2P 加速一定产生预期收益。受当时行业技术水平限制而无法避免的缺陷,不视为 MeshStream 违约。
|
|
137
|
+
|
|
138
|
+
下列情形不属于 MeshStream 可控范围或违约责任范围:计划维护、紧急维护、容量调整和产品升级;互联网链路、运营商、云基础设施、DNS、浏览器、WebRTC 或第三方服务故障;您的播放器、源站、CDN、鉴权、域名、配置、内容授权或终端设备问题;黑客、病毒、DDoS、恶意流量、网络攻击;监管措施、政府行为、战争、罢工、自然灾害、公共卫生事件及其他不可抗力。我们会在合理可行范围内采取措施降低影响并恢复服务。
|
|
139
|
+
|
|
140
|
+
因客户内容、源站、CDN、播放器、终端用户、第三方服务或您违反本协议造成的任何索赔、处罚、损失或费用,不属于 MeshStream 的责任范围。前述责任限制不适用于法律不允许限制的责任,也不免除您对已产生服务费用的付款义务。
|
|
141
|
+
|
|
142
|
+
在法律允许的最大范围内,MeshStream 不对任何间接、附带、特殊、惩罚性或后果性损失,以及利润、商誉、商机、预期节省、数据或业务中断损失承担责任。除法律另有强制规定外,MeshStream 就本协议承担的累计赔偿责任,以引发责任的相关服务发生前十二个月内您实际支付的相关服务费用为上限;免费服务、试用服务和赠送额度不产生赔偿基数。
|
|
143
|
+
|
|
144
|
+
如第三方因您的内容、产品、用户行为、未获授权的数据处理、知识产权侵权或违反适用法律向 MeshStream 提出投诉、索赔、处罚或诉讼,您应及时接管处理并使 MeshStream 免责,赔偿 MeshStream 因此遭受的损失、费用和合理的律师费。未经 MeshStream 书面同意,您不得就该等索赔作出会使 MeshStream 承担责任的承认或和解。
|
|
145
|
+
|
|
146
|
+
## 十、保密
|
|
147
|
+
|
|
148
|
+
双方对在服务过程中获悉的对方非公开技术、业务、价格、客户和安全信息承担保密义务,除为履行本协议、获得专业顾问协助、使用受约束的服务商或依法应向监管及司法机关披露外,不得向无关第三方披露。接收方应采取不低于保护自身同类信息的合理措施,并在发现泄露时及时通知对方。本条在协议终止后继续有效,直至相关信息合法进入公开领域。
|
|
149
|
+
|
|
150
|
+
## 十一、协议更新与争议处理
|
|
151
|
+
|
|
152
|
+
我们可能根据服务变化、法律要求或风险控制需要更新本协议。更新后会在官网公布新的生效日期;重大变化会通过控制台、注册邮箱或其他合理方式提示。继续使用服务即表示接受更新后的协议。
|
|
153
|
+
|
|
154
|
+
本协议的解释、履行和争议处理适用 MeshStream 运营主体所在地适用的法律。运营主体、争议解决地和正式的服务通知地址以本协议当前版本、订单或法律通知中公布的信息为准。
|
|
155
|
+
|
|
156
|
+
我们向您在控制台、注册邮箱或本协议列明的联系方式发送通知,或在官网公告后,视为已完成合理通知。您应确保联系方式真实、有效并及时更新。
|
|
157
|
+
|
|
158
|
+
## 十二、联系我们
|
|
159
|
+
|
|
160
|
+
- 协议、账号和服务支持:`support@meshstream.net`
|
|
161
|
+
- 隐私请求、安全事件和法律通知:`support@meshstream.net`
|
|
162
|
+
|
|
163
|
+
## 十三、新加坡区域补充条款
|
|
164
|
+
|
|
165
|
+
如控制台或订单标示已启用新加坡区域,该区域适用控制台、订单和技术文档中标明的区域、数据处理和服务边界。选择新加坡区域不构成对特定国家或地区持续可用性的保证;未标示启用的区域不构成可用性承诺。
|
|
166
|
+
|
|
167
|
+
如您使用 MeshStream 处理终端用户、客户或其他个人的信息,您承诺已经取得必要的授权、同意和业务许可,并会向相关人员提供符合法律要求的隐私告知。您不得通过 SDK、P2P、回源、日志或控制台上传、传播或处理违法、侵权、欺诈、赌博、色情、暴力极端、恶意软件或其他受禁止内容。
|
|
168
|
+
|
|
169
|
+
您应按照适用的数据保护法律履行安全、删除、访问、更正、跨境传输和事件通知义务,并在收到 MeshStream 的合理合规请求时及时配合。若您的处理活动需要指定数据保护负责人、完成影响评估、取得跨境传输依据或向监管机构通报,相关责任由您承担。
|
|
170
|
+
|
|
171
|
+
MeshStream 可以为提供全球接入、灾备、邮件、支付、监控、安全和客户支持,在必要范围内使用受约束的服务商或进行跨境处理;我们会依据适用法律和本协议采取合理的合同、技术和组织措施。区域服务、服务商或处理地点发生重大变化时,我们会通过协议约定的方式进行通知。
|
|
172
|
+
|
|
173
|
+
本补充条款适用于控制台或订单明确标示的新加坡区域服务。若本补充条款与订单或双方另行签署的数据处理协议不一致,以后者为准。
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
---
|
|
2
|
+
sidebar_position: 2
|
|
3
|
+
title: 快速开始
|
|
4
|
+
description: 用一条媒体播放链路完成 MeshStream 的首次接入和验收。
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
import Tabs from '@theme/Tabs';
|
|
8
|
+
import TabItem from '@theme/TabItem';
|
|
9
|
+
|
|
10
|
+
# 快速开始
|
|
11
|
+
|
|
12
|
+
本指南用于验证一条完整的播放链路:创建应用和 SDK Key、建立播放会话、将 SDK 返回的播放地址交给现有播放器,并确认加速不可用时仍能正常播放。
|
|
13
|
+
|
|
14
|
+
## 前置条件
|
|
15
|
+
|
|
16
|
+
- 一个可播放的 HLS `.m3u8`、DASH `.mpd`、支持 Range 的 MP4 或 MP3 地址;
|
|
17
|
+
- 已在控制台创建应用和对应平台的 SDK Key;
|
|
18
|
+
- 播放器已经能够独立播放原始媒体地址;
|
|
19
|
+
- 业务侧已准备好源站鉴权所需的签名 URL、Cookie 或请求头。
|
|
20
|
+
|
|
21
|
+
<span id="原生与跨平台-sdk-版本对照" />
|
|
22
|
+
|
|
23
|
+
各端安装入口、当前版本与原生依赖关系统一列在[选择 SDK](./sdk/overview.md)中。
|
|
24
|
+
|
|
25
|
+
## 1. 创建应用和 SDK Key
|
|
26
|
+
|
|
27
|
+
在控制台创建应用,再为目标平台创建 SDK Key。SDK Key 用于标识应用和接入平台,可以随客户端发布;它不具备管理后台权限,账号密码、管理凭证和源站密钥不得写入客户端。
|
|
28
|
+
|
|
29
|
+
应用的归属区域由平台配置确定,业务代码不需要在 SDK 初始化时额外传入区域字段。
|
|
30
|
+
|
|
31
|
+
## 2. 按平台接入
|
|
32
|
+
|
|
33
|
+
所有平台遵循同一接入原则:为每次播放创建独立会话,将会话返回的 `playbackUrl` 交给现有播放器,并在播放结束或切换内容时释放会话。
|
|
34
|
+
|
|
35
|
+
<Tabs groupId="platform" queryString="platform">
|
|
36
|
+
<TabItem value="web" label="Web" default>
|
|
37
|
+
|
|
38
|
+
安装 SDK,并将会话绑定到现有的 `<video>` 元素:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
npm install @meshstream/p2p-web
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { attach } from "@meshstream/p2p-web";
|
|
46
|
+
|
|
47
|
+
const session = attach({
|
|
48
|
+
key: "your_sdk_key",
|
|
49
|
+
url: "https://cdn.example.com/video/master.m3u8",
|
|
50
|
+
video: document.querySelector("video")!,
|
|
51
|
+
contentId: "movie-2026-001",
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
const result = await session.start();
|
|
55
|
+
console.log(result.mode);
|
|
56
|
+
|
|
57
|
+
// 页面卸载或切换媒体内容时
|
|
58
|
+
session.dispose();
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
[查看 Web SDK 安装与配置](./sdk/web-setup.md)
|
|
62
|
+
|
|
63
|
+
</TabItem>
|
|
64
|
+
<TabItem value="android" label="Android">
|
|
65
|
+
|
|
66
|
+
在项目仓库中添加 Maven 仓库:
|
|
67
|
+
|
|
68
|
+
```kotlin
|
|
69
|
+
maven {
|
|
70
|
+
url = uri("https://sdk.meshstream.net/maven")
|
|
71
|
+
content { includeGroup("io.meshstream") }
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
在应用模块中声明依赖:
|
|
76
|
+
|
|
77
|
+
```kotlin
|
|
78
|
+
implementation("io.meshstream:meshstream-android-sdk:1.0.10")
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
创建客户端和播放会话,并将 `playbackUrl` 交给 Media3 / ExoPlayer:
|
|
82
|
+
|
|
83
|
+
```kotlin
|
|
84
|
+
val client = P2pSdk.create(
|
|
85
|
+
applicationContext,
|
|
86
|
+
P2pConfig(key = "your_sdk_key"),
|
|
87
|
+
)
|
|
88
|
+
val session = client.createPlaybackSession(
|
|
89
|
+
originUrl,
|
|
90
|
+
PlaybackOptions(contentId = "movie-2026-001"),
|
|
91
|
+
)
|
|
92
|
+
|
|
93
|
+
player.setMediaItem(MediaItem.fromUri(session.playbackUrl))
|
|
94
|
+
player.prepare()
|
|
95
|
+
player.play()
|
|
96
|
+
|
|
97
|
+
// 切换内容或销毁播放页面时
|
|
98
|
+
session.close()
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
[查看 Android SDK 安装与配置](./sdk/android-setup.md)
|
|
102
|
+
|
|
103
|
+
</TabItem>
|
|
104
|
+
<TabItem value="ios" label="iOS / macOS">
|
|
105
|
+
|
|
106
|
+
通过 CocoaPods 安装:
|
|
107
|
+
|
|
108
|
+
```ruby
|
|
109
|
+
pod 'MeshStreamKit', '1.0.10'
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
执行 `pod install --repo-update` 安装依赖。已有项目使用 `Podfile.lock` 锁定的版本;升级 SDK 时先将 `Podfile` 中精确锁定的 `1.0.10` 改为目标已发布版本,再执行 `pod update MeshStreamKit --repo-update`。其他安装方式与应用权限配置见 [iOS / macOS SDK 安装与配置](./sdk/ios-setup.md)。
|
|
113
|
+
|
|
114
|
+
在播放管理器中持有 `self.client`、`self.session` 和 `self.player` 属性,并执行以下代码。SDK Key 需对应目标平台及已登记的 Bundle ID;`originURL` 为原始媒体地址:
|
|
115
|
+
|
|
116
|
+
```objc
|
|
117
|
+
#import <MeshStreamKit/MeshStreamKit.h>
|
|
118
|
+
#import <AVFoundation/AVFoundation.h>
|
|
119
|
+
|
|
120
|
+
P2PConfig *config = [[P2PConfig alloc] initWithKey:@"your_sdk_key"];
|
|
121
|
+
NSError *clientError = nil;
|
|
122
|
+
self.client = [P2PSDK clientWithConfig:config error:&clientError];
|
|
123
|
+
if (self.client == nil) {
|
|
124
|
+
// 按业务错误处理策略提示或回退。
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
P2PPlaybackOptions *options = [[P2PPlaybackOptions alloc] init];
|
|
129
|
+
options.contentId = @"movie-2026-001";
|
|
130
|
+
NSError *playbackError = nil;
|
|
131
|
+
self.session = [self.client createPlaybackSessionWithURL:originURL
|
|
132
|
+
options:options
|
|
133
|
+
error:&playbackError];
|
|
134
|
+
if (self.session == nil) {
|
|
135
|
+
return;
|
|
136
|
+
}
|
|
137
|
+
AVPlayerItem *item = [AVPlayerItem playerItemWithURL:self.session.playbackUrl];
|
|
138
|
+
self.player = [AVPlayer playerWithPlayerItem:item];
|
|
139
|
+
[self.player play];
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
将播放器关联至应用的播放视图。结束播放或切换内容时,在对应的生命周期回调中释放旧媒体引用及会话:
|
|
143
|
+
|
|
144
|
+
```objc
|
|
145
|
+
[self.player pause];
|
|
146
|
+
[self.player replaceCurrentItemWithPlayerItem:nil];
|
|
147
|
+
[self.session close];
|
|
148
|
+
self.session = nil;
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
[查看 iOS / macOS SDK 安装与配置](./sdk/ios-setup.md)
|
|
152
|
+
|
|
153
|
+
</TabItem>
|
|
154
|
+
<TabItem value="windows" label="Windows">
|
|
155
|
+
|
|
156
|
+
引入 C ABI 头文件,创建客户端和播放会话,并将 SDK 返回的地址交给桌面播放器:
|
|
157
|
+
|
|
158
|
+
```c
|
|
159
|
+
#include "meshstream.h"
|
|
160
|
+
|
|
161
|
+
meshstream_config_t config;
|
|
162
|
+
meshstream_config_default(&config);
|
|
163
|
+
config.key = "your_sdk_key";
|
|
164
|
+
|
|
165
|
+
meshstream_client_t* client = NULL;
|
|
166
|
+
meshstream_client_create(&config, &client);
|
|
167
|
+
|
|
168
|
+
meshstream_session_t* session = NULL;
|
|
169
|
+
meshstream_playback_options_t options = {0};
|
|
170
|
+
options.struct_size = sizeof(options);
|
|
171
|
+
options.version = MESHSTREAM_PLAYBACK_OPTIONS_VERSION;
|
|
172
|
+
options.content_id = "movie-2026-001";
|
|
173
|
+
|
|
174
|
+
meshstream_client_create_playback_session(
|
|
175
|
+
client, playback_url, &options, &session, NULL);
|
|
176
|
+
const char* sdk_playback_url = meshstream_session_get_playback_url(session);
|
|
177
|
+
// 将 sdk_playback_url 交给 VLC、ffplay 或业务播放器。
|
|
178
|
+
|
|
179
|
+
// 播放结束时,先销毁会话,再销毁客户端。
|
|
180
|
+
meshstream_session_destroy(session);
|
|
181
|
+
meshstream_client_destroy(client);
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
[查看 Windows SDK 安装与配置](./sdk/windows-setup.md)
|
|
185
|
+
|
|
186
|
+
</TabItem>
|
|
187
|
+
</Tabs>
|
|
188
|
+
|
|
189
|
+
## 3. 验收播放链路
|
|
190
|
+
|
|
191
|
+
按以下标准完成首次验收:
|
|
192
|
+
|
|
193
|
+
1. 播放器加载的是 SDK 返回的 `playbackUrl`,而不是原始媒体地址;
|
|
194
|
+
2. 切换媒体内容、页面卸载或播放结束时,旧会话已释放;
|
|
195
|
+
3. 暂时关闭 P2P 或阻断加速连接后,媒体仍能通过原有 CDN 播放完成;
|
|
196
|
+
4. 控制台可以查询到会话和用量数据。统计采用异步处理,可能存在短暂延迟。
|
|
197
|
+
|
|
198
|
+
加速能力不可用不等于媒体不可播放。业务错误处理应以播放器和媒体源的实际状态为准,不应仅因 P2P 状态停止播放。
|