wholetrans/docs-mastodon
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
docs-mastodon/content/zh-cn/entities/PreviewCard.md

7.5 KiB
Raw Blame History

title description menu aliases
PreviewCard 表示使用来自 URL 的 OpenGraph 标签生成的富媒体预览卡片。
docs
parent
entities
/entities/card
/entities/Card
/entities/previewcard
/entities/PreviewCard
/api/entities/card
/api/entities/Card
/api/entities/previewcard
/api/entities/PreviewCard

示例

视频

{
  "url": "https://www.youtube.com/watch?v=OMv_EPMED8Y",
  "title": "♪ Brand New Friend (Christmas Song!)",
  "description": "",
  "type": "video",
  "author_name": "YOGSCAST Lewis & Simon",
  "author_url": "https://www.youtube.com/user/BlueXephos",
  "provider_name": "YouTube",
  "provider_url": "https://www.youtube.com/",
  "html": "<iframe width=\"480\" height=\"270\" src=\"https://www.youtube.com/embed/OMv_EPMED8Y?feature=oembed\" frameborder=\"0\" allowfullscreen=\"\"></iframe>",
  "width": 480,
  "height": 270,
  "image": "https://files.mastodon.social/preview_cards/images/014/179/145/original/9cf4b7cf5567b569.jpeg",
  "embed_url": "",
  "blurhash": "UvK0HNkV,:s9xBR%njog0fo2W=WBS5ozofV@"
}

图片

{
  "url": "https://www.flickr.com/photos/tomfenskephotography/49088768431/",
  "title": "Oregon",
  "description": "",
  "type": "photo",
  "author_name": "Tom Fenske Photography",
  "author_url": "https://www.flickr.com/photos/tomfenskephotography/",
  "provider_name": "Flickr",
  "provider_url": "https://www.flickr.com/",
  "html": "",
  "width": 1024,
  "height": 427,
  "image": "https://files.mastodon.social/preview_cards/images/014/287/139/original/651b1c6976817824.jpeg",
  "embed_url": "https://live.staticflickr.com/65535/49088768431_6a4322b3bb_b.jpg",
  "blurhash": "UnE{@jt6M_oIAhjYs+ayT2WBf9ayRkkDXAj["
}

链接

{
  "url": "https://www.theguardian.com/money/2019/dec/07/i-lost-my-193000-inheritance-with-one-wrong-digit-on-my-sort-code",
  "title": "‘I lost my £193,000 inheritance – with one wrong digit on my sort code’",
  "description": "When Peter Teich’s money went to another Barclays customer, the bank offered £25 as a token gesture",
  "type": "link",
  "authors": [],
  "author_name": "",
  "author_url": "",
  "provider_name": "",
  "provider_url": "",
  "html": "",
  "width": 0,
  "height": 0,
  "image": null,
  "embed_url": "",
  "blurhash": null
}

属性

url

描述: 链接资源的地址。
类型: 字符串 (URL)
版本历史:
1.0.0 - 添加

title

描述: 链接资源的标题。
类型: 字符串
版本历史:
1.0.0 - 添加

description

描述: 预览的描述。
类型: 字符串
版本历史:
1.0.0 - 添加

type

描述: 预览卡片的类型。
类型: 字符串 (可枚举, oneOf)
link = 链接 OEmbed
photo = 图片 OEmbed
video = 视频 OEmbed
rich = iframe OEmbed。当前不接受，因此实际上不会显示。
版本历史:
1.3.0 - 添加

authors

描述: 原始资源的作者的 Fediverse 账号。
类型: Array of [PreviewCardAuthor]({{< relref "entities/PreviewCardAuthor">}})
版本历史:
4.3.0 - 添加

author_name

描述: 原始资源的作者。自 4.3.0 起已弃用，客户端应改用 authors。
类型: 字符串
版本历史:
1.3.0 - 添加
4.3.0 - deprecated

author_url

描述: 指向原始资源作者的链接。自 4.3.0 起已弃用，客户端应改用 authors。
类型: 字符串 (URL)
版本历史:
1.3.0 - 添加
4.3.0 - deprecated

provider_name

描述: 原始资源的提供者。
类型: 字符串
版本历史:
1.3.0 - 添加

provider_url

描述: 指向原始资源提供者的链接。
类型: 字符串 (URL)
版本历史:
1.3.0 - 添加

html

描述: 用于生成预览卡片的 HTML。
类型: 字符串 (HTML)
版本历史:
1.3.0 - 添加

width

描述: 预览的宽度，以像素为单位。
类型: 整数
版本历史:
1.3.0 - 添加

height

描述: 预览的高度，以像素为单位。
类型: 整数
版本历史:
1.3.0 - 添加

image

描述: 预览缩略图。
类型: {{}} 字符串 (URL)
版本历史:
1.0.0 - 添加

embed_url

描述: 用于照片嵌入，替代自定义的 html。
类型: 字符串 (URL)
版本历史:
2.1.0 - 添加

blurhash

描述: 由 BlurHash 算法计算出的哈希值，用于在媒体尚未下载时生成彩色预览缩略图。
类型: {{}} 字符串
版本历史:
3.2.0 - 添加

Trends::Link 实体属性

{
  "url": "https://www.nbcnews.com/specials/plan-your-vote-2022-elections/index.html",
  "title": "Plan Your Vote: 2022 Elections",
  "description": "Everything you need to know about the voting rules where you live, including registration, mail-in voting, changes since 2020, and more.",
  "type": "link",
  "author_name": "NBC News",
  "author_url": "",
  "provider_name": "NBC News",
  "provider_url": "",
  "html": "",
  "width": 400,
  "height": 225,
  "image": "https://files.mastodon.social/cache/preview_cards/images/045/027/478/original/0783d5e91a14fd49.jpeg",
  "embed_url": "",
  "blurhash": "UcQmF#ay~qofj[WBj[j[~qof9Fayofofayay",
  "history": [
    {
      "day": "1661817600",
      "accounts": "7",
      "uses": "7"
    },
    {
      "day": "1661731200",
      "accounts": "23",
      "uses": "23"
    },
    {
      "day": "1661644800",
      "accounts": "0",
      "uses": "0"
    },
    {
      "day": "1661558400",
      "accounts": "0",
      "uses": "0"
    },
    {
      "day": "1661472000",
      "accounts": "0",
      "uses": "0"
    },
    {
      "day": "1661385600",
      "accounts": "0",
      "uses": "0"
    },
    {
      "day": "1661299200",
      "accounts": "0",
      "uses": "0"
    }
  ]
}

history

描述: 给定日期的使用统计信息（通常是过去一周）。
类型: 哈希值的数组
版本历史:
3.5.0 - 添加

history[][day]

描述: 给定日期午夜的 UNIX 时间戳。
类型: 字符串 (UNIX 时间戳)
版本历史:
3.5.0 - 添加

history[][accounts]

描述: 当天使用该链接的已计数帐户数。
类型: 字符串 (从整数转换而来)
版本历史:
3.5.0 - 添加

history[][uses]

描述: 当天使用该链接的已计数嘟文数。
类型: 字符串 (从整数转换而来)
版本历史:
3.5.0 - 添加

参见

{{< page-relref ref="entities/Status#card" caption="Status (card 属性)" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/preview_card_serializer.rb" caption="app/serializers/rest/preview_card_serializer.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/trends/link_serializer.rb" caption="app/serializers/rest/trends/link_serializer.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/trends/links.rb" caption="app/models/trends/links.rb" >}}

{{< translation-status-zh-cn raw_title="PreviewCard" raw_link="/entities/PreviewCard/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}