# LINE 连接

LINE connection 让您使用 [LIFF](https://developers.line.biz/en/docs/liff/overview/) 或 [LINE MINI App](https://developers.line.biz/en/docs/line-mini-app/discover/introduction/) 渠道在 LINE 内发布 DailyPlay **streams**。玩家打开永久 LINE 链接并在 LINE 中游玩您的活动 — 无需 Messaging API 或渠道密钥。

:::note
LINE 是**发布**连接，而非事件 webhook。它不像 Braze 或 Zapier 那样链接到 stream 触发事件。Webhook 提供方见 [Connections 概览](/zh/connections/overview)。
:::

---

## 前提条件

| 要求 | 在哪里找到 |
| :---------- | :--------------- |
| **LINE Developers account** | [LINE Developers Console](https://developers.line.biz/console/) |
| **LIFF app**（或 LINE MINI App 渠道） | LINE Developers Console → 您的提供方 → LIFF / MINI App |
| **Public LIFF ID** | 显示在 LIFF（或 MINI App）设置页面 — 例如 `1234567890-AbCdEfGh` |

:::tip
当 MINI App 渠道创建不可用时（在泰国常见），优先使用 **Classic LIFF**（`liff.line.me`）。仅当您拥有已批准的 MINI App 渠道（通常为日本 / 已批准提供方）时才使用 **LINE MINI App**（`miniapp.line.me`）。
:::

---

## 设置连接

1. 从主导航前往 **Connections**
2. 点击 **Add Connection** 并选择 **LINE (LIFF / MINI App)**
3. 输入：
   - **LIFF ID**（必填）— 仅您的公开 LIFF ID；**不要**粘贴渠道密钥或访问令牌
   - **Link type** — Classic LIFF（推荐）或 LINE MINI App
   - **LINE Basic ID**（可选）— 例如 `@yourbrand`
   - **Official Account page URL**（可选）— 例如 `https://page.line.me/…`
4. 保存连接

### 在 LINE 中配置 Endpoint URL

在 LINE Developers Console 中，将 LIFF（或 MINI App）的 **Endpoint URL** 设置为：

```
https://app.dailyplay.ai/?liff_id=YOUR_LIFF_ID
```

将 `YOUR_LIFF_ID` 替换为您在 DailyPlay 中输入的相同 LIFF ID。需要 `liff_id` 查询参数，以便 DailyPlay 在打开 stream 前初始化 LIFF。

然后确保 LIFF 应用在 LINE Developers Console 中已 **Added**（或发布您的 MINI App 渠道）。

---

## 将 Stream 发布到 LINE

组织存在有效的 LINE connection 后：

1. 打开您要发布的 stream
2. 打开 **Share** 选项
3. 使用 **Publish to LINE** 面板：
   - 复制 **LINE permanent link**
   - 按照设置清单操作（Endpoint URL、LIFF/MINI App 已发布、链接已添加到 OA）

### 永久链接格式

| 链接类型 | URL 模式 |
| :-------- | :---------- |
| Classic LIFF | `https://liff.line.me/{liff_id}/stream/{org-slug}/{stream-slug}` |
| LINE MINI App | `https://miniapp.line.me/{liff_id}/stream/{org-slug}/{stream-slug}` |

### 将链接添加到官方账号

将永久链接放入 LINE Official Account 的**图文菜单**或**图文消息**中，让关注者一键打开 stream。

---

## 在 LINE 上分享

从 stream（或游戏）分享面板，您也可以使用 **Share on LINE**：

- **Mobile** — 打开带预填消息的 LINE 分享表单
- **Desktop** — 复制消息以便粘贴到 LINE

当 LINE connection 有效时，分享消息使用永久 LIFF/MINI App URL。否则使用普通 stream（或游戏）URL。

:::note
永久 **Publish to LINE** 链接适用于 **streams**。单个游戏仅支持 Share on LINE。
:::

---

## 工作原理

1. 玩家打开永久 LINE 链接（来自图文菜单、图文消息或分享消息）
2. LINE 使用您配置的 Endpoint URL 与 `liff.state` 加载 DailyPlay
3. DailyPlay 初始化 LIFF，然后打开 stream 路径
4. 玩家在 LINE 内游玩 stream

若 LIFF 初始化失败，或玩家在 LINE 应用内浏览器中打开普通 `https://app.dailyplay.ai/stream/…` 链接，stream 仍会作为普通网页加载。

---

## 管理连接

- **Edit** — 从 **Connections** 更新 LIFF ID、链接类型、Basic ID 或 OA 页面 URL
- **Enable / Disable** — 切换连接而不删除（禁用的连接会隐藏 Publish to LINE 面板）
- **Delete** — 从组织中永久移除 LINE connection

:::note
仅组织 **owners** 与 **admins** 可创建、编辑或删除连接。
:::

---

## 故障排除

### Publish to LINE 面板不出现

- 确认您创建的是 **LINE (LIFF / MINI App)** 连接（而非 webhook）
- 确保连接已**启用**
- 打开 **stream** 分享面板 — 永久发布仅适用于 stream

### Stream 在 LINE 中打开为空白页

- 核实 Endpoint URL 恰好为 `https://app.dailyplay.ai/?liff_id=YOUR_LIFF_ID`
- 确认 DailyPlay 中的 LIFF ID 与 LINE Developers Console 中的 LIFF 应用匹配
- 确保 LIFF 应用已 Added（或 MINI App 渠道已发布）

### 永久链接能打开但 stream 无法加载

- 检查 URL 中的 org slug 与 stream slug 是否正确
- 确认 stream 在 DailyPlay 中已发布 / 可玩
- 尝试在普通浏览器中打开普通 stream URL，以隔离 LINE 特定问题

### Share on LINE 复制消息而非打开 LINE

- 在桌面端，不支持 LINE 的分享 URL — DailyPlay 会为您复制消息以便粘贴
- 在移动端，LINE 分享表单应自动打开

---

## 限制

- 此集成不包含 LINE Messaging API、推送消息或机器人 webhooks
- 不存储渠道密钥与访问令牌 — 仅粘贴公开 LIFF ID
- LINE 不能作为 stream 事件接收端附加（与 Braze、Zapier 或 webhooks 不同）

---

## 下一步

- [Connections 概览](/zh/connections/overview)
- [Streams 概览](/zh/streams/overview)
- [分享您的游戏](/zh/sharing/share)