Hot Tub

Hot Tub 是一款用于添加来源和打开视频的视频应用。Protocol Launcher 允许你生成 Hot Tub URL scheme 链接。

使用

有两种方式使用此库：

• On-Demand 从子路径导入，有利于 tree-shaking 并保持包体积较小。
• Full Import 从根包导入，写起来更方便，但会包含所有应用模块。

生产构建建议使用 On-Demand；快速脚本或演示可以使用 Full Import。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

说明

此模块只暴露 Hot Tub 官方 URL Schemes 文档列出的 custom URL scheme 动作：source、webview、search、profile、play、notification 和 message。

play helper 接收 video 或 url 二选一：video 用于基于 API 的视频，url 用于网页播放器。对于 profile，Hot Tub 文档使用 uploader，同时说明 custom scheme 接受 creator 作为别名。

同一篇官方文档还记录了 https://hottubapp.io/add/{domain} source redirect 和 https://<host>/app?... universal-link handoff。Handoff helpers 要求传入 baseUrl，因为 Hot Tub 文档说明这个 host 必须提供 /app 并配置 associated domain。

添加 Source

On-Demand

import { addSource } from 'protocol-launcher/hot-tub'

const url = addSource({
  url: 'https://api.myvideosite.com',
})

添加 Source

添加 Source Redirect

On-Demand

import { addSourceRedirect } from 'protocol-launcher/hot-tub'

const url = addSourceRedirect({
  domain: 'api.myvideosite.com',
})

打开 Source Redirect

打开网页

On-Demand

import { openWebView } from 'protocol-launcher/hot-tub'

const url = openWebView({
  url: 'https://help.example.com',
})

打开网页

搜索

On-Demand

import { search } from 'protocol-launcher/hot-tub'

const url = search({
  q: 'funny cats',
})

搜索

打开 Uploader Profile

On-Demand

import { openProfile } from 'protocol-launcher/hot-tub'

const url = openProfile({
  uploader: 'yanks',
})

打开 Uploader Profile

Handoff 搜索

On-Demand

import { handoffSearch } from 'protocol-launcher/hot-tub'

const url = handoffSearch({
  baseUrl: 'https://hottubapp.io',
  q: 'nature documentaries',
})

打开搜索 Handoff

Handoff Profile

On-Demand

import { handoffProfile } from 'protocol-launcher/hot-tub'

const url = handoffProfile({
  baseUrl: 'https://hottubapp.io',
  uploader: 'yanks',
})

打开 Profile Handoff

Handoff 通用页面

On-Demand

import { handoffOpen } from 'protocol-launcher/hot-tub'

const url = handoffOpen({
  baseUrl: 'https://hottubapp.io',
  url: 'https://example.com/watch/12345',
})

打开页面 Handoff

Handoff Favorite

On-Demand

import { handoffFavorite } from 'protocol-launcher/hot-tub'

const url = handoffFavorite({
  baseUrl: 'https://hottubapp.io',
  url: 'https://example.com/watch/12345',
})

打开 Favorite Handoff

播放视频

On-Demand

import { play } from 'protocol-launcher/hot-tub'

const url = play({
  video: 'https://www.youtube.com/watch?v=y0sF5xhGreA',
})

播放视频

播放网页视频

On-Demand

import { play } from 'protocol-launcher/hot-tub'

const url = play({
  url: 'https://www.youtube.com/watch?v=y0sF5xhGreA',
})

播放网页视频

通知

On-Demand

import { notification } from 'protocol-launcher/hot-tub'

const url = notification({
  type: 'success',
  title: 'Success',
  message: 'Video added to playlist!',
})

显示通知

Debug Message

On-Demand

import { message } from 'protocol-launcher/hot-tub'

const url = message({
  content: 'Configuration loaded: API v2.1, 15 channels active',
})

显示 Debug Message

官方文档

• Hot Tub URL Schemes