1. 引言
Activity Streams 2.0 核心语法定义了 Activity Streams 的 JSON 语法。本文档定义了词汇集属性。
Activity Streams 2.0 词汇集定义了一组抽象类型与属性，用于描述过去、现在与未来的活动。该词汇集由两部分定义：
-
描述 Activity 广义结构的核心属性集；以及
-
扩展属性集，包括许多社交 Web 应用程序系统中常见的特定类型的活动与产物。
虽然不期望所有 Activity Streams 2.0 实现都支持扩展属性，但所有实现必须至少能根据 Activity Streams 2.0 核心语法对扩展属性进行序列化与反序列化。
本文档中的关键词 "必须"、"不得"、"要求"、"应当"、"不应"、"应该"、"不该"、"建议"、"可以"与"可选"应按照 [RFC2119] 中的描述进行解释。
1.1 约定
除非另有说明，否则所有值类型定义为
xsd:dateTime 的属性必须符合 Activity Streams 2.0 核心规范 2.3 节的规定。
本文档中包含的示例使用本规范定义的规范性 JSON 进行序列化。
5. 实现说明
5.1 受众定位
从概念上讲，每个对象都有主要受众与次要受众。主要受众由直接参与或拥有该对象的实体组成。次要受众由对该对象有共同兴趣但可能不直接参与的实体集合组成（例如“粉丝”）。
例如，假设有一个由三个人组成的社交网络：Bob、Joe 与 Jane。Bob 与 Joe 都是 Jane 的朋友，但他们彼此不是朋友。Bob 选择“关注”Jane 直接参与的活动。Jane 与 Joe 分享了一个文件。
在这个例子中，Jane 与 Joe 都直接参与了文件分享活动，他们共同构成了该事件的主要受众。Bob 对涉及 Jane 的活动感兴趣，因此是次要受众。了解到这一点后，生产或消费该活动的系统就可以智能地将该事件通知给每个人。
虽然有一些手段（基于活动的类型、行为体、对象与目标）可以推断许多类型活动的主要受众，但启发式方法并非在任何情形下都有效，也不能提供识别次要受众的方法。对象中 可以 使用
to、cc、bto 与 bcc 属性来明确标识主要与次要受众。
包含这些属性的对象的典型用例是通过中介发布与重新分发对象。也就是说，事件源生成对象并将其发布给中介，中介决定向特定的个人用户或群组显示哪些项目子集。这种决定可以通过识别每个对象的主要与次要受众来做出。
当事件源生成对象并指定 to 与 cc 字段的值时，中介 应该 在保留这些字段值的情形下重新分发该对象，从而允许任何处理器看到该对象的目标受众是谁。这与电子邮件系统中使用的 to 与 cc 字段的模型完全相同。
然而，在某些情形下，公开受众中特定成员的身份可能是不恰当的。例如，用户可能不希望让其它用户知道他们对各种话题、个人或事件类型感兴趣。为了支持这种选择，生成对象的实现 可以 使用
bto 与 bcc 属性来列出对象应私下定向到的实体。当中介接收到包含这些属性的对象时，它
必须 在重新分发对象之前移除这些值。其意图是，系统 必须 将
bto 与 bcc 属性中列出的实体视为主要与次要受众的一部分，但 不得 向任何其它方透露这一事实。
包含在对象中的受众定位信息仅描述了对象创建者的意图。除了对 bto 与
bcc 的适当处理有明确例外之外，本规范由实现者自行决定如何使用受众定位信息。
5.1.1 受众与上下文
本节为非规范性内容。
活动很少是孤立的事件。通常，多个单独的活动会围绕相似的上下文或受众进行。例如，在同一个项目上工作的协作者可能会在实现某个目标的过程中执行多个相关的活动。这些活动可以使用 context属性在逻辑上进行分组，并使用 audience属性将其范围限定为特定受众。
例如，以下示例显示了共享同一个 context 与 audience 的两个相关活动：
示例 144
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "项目 XYZ 的 活动",
"type": "Collection",
"items": [
{
"summary": "Sally 创建了一条贴文",
"type": "Create",
"id": "http://activities.example.com/1",
"actor": "http://sally.example.org",
"object": {
"summary": "A note",
"type": "Note",
"id": "http://notes.example.com/1",
"content": "A note"
},
"context": {
"type": "http://example.org/Project",
"name": "项目 XYZ"
},
"audience": {
"type": "Group",
"name": "项目 XYZ 工作组"
},
"to": "http://john.example.org"
},
{
"summary": "John 点赞了 Sally 的贴文",
"type": "Like",
"id": "http://activities.example.com/1",
"actor": "http://john.example.org",
"object": "http://notes.example.com/1",
"context": {
"type": "http://example.org/Project",
"name": "项目 XYZ"
},
"audience": {
"type": "Group",
"name": "项目 XYZ 工作组"
},
"to": "http://sally.example.org"
}
]
}
5.2 表示实体间的关系
Relationship 对象用于表示个人之间的关系。例如，它可用于描述一个人是另一个人的朋友，或者一个人是特定组织的成员。以这种方式对关系建模的意图是允许描述对关系本身进行操作的活动，并允许表示关系的集合。
例如，许多社交系统都有“好友列表”的概念。这是指在某人的社交图谱中直接连接的个体集合。假设我们有一个用户 Sally，她与用户 Joe 与 Jane 有直接关系。Sally 关注 Joe 的更新，而 Sally 与 Jane 之间是互相关注的关系。
使用 Relationship 对象，我们可以将这些关系建模为：
示例 145
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Sally 的好友列表",
"type": "Collection",
"items": [
{
"summary": "Sally 受 Joe 的影响",
"type": "Relationship",
"subject": {
"type": "Person",
"name": "Sally"
},
"relationship": "http://purl.org/vocab/relationship/influencedBy",
"object": {
"type": "Person",
"name": "Joe"
}
},
{
"summary": "Sally 是 Jane 的朋友",
"type": "Relationship",
"subject": {
"type": "Person",
"name": "Sally"
},
"relationship": "http://purl.org/vocab/relationship/friendOf",
"object": {
"type": "Person",
"name": "Jane"
}
}
]
}
relationship 属性指定了由
subject 与
object 属性标识的两个个体之间存在的关系种类。这三个属性一起使用构成了通常所说的“具体化语句”，其中 subject 标识主体，relationship 标识谓词，而
object 标识客体。
虽然在某些情形下使用具体化语句可能会有问题和令人困惑，但在 Activity Streams 词汇集中，使用它们来描述关系提供了一种描述个人社交图谱变化的简单机制。例如，为了表明 Sally 与用户 Matt 建立了新关系，实现者可以将
Relationship 对象与
Create 活动结合使用：
示例 146
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Sally 与 Matt 成为了朋友",
"type": "Create",
"actor": "http://sally.example.org",
"object": {
"type": "Relationship",
"subject": "http://sally.example.org",
"relationship": "http://purl.org/vocab/relationship/friendOf",
"object": "http://matt.example.org",
"startTime": "2015-04-21T12:34:56"
}
}
此外，以这种方式对关系进行建模允许实现者阐明关系本身的附加属性。例如，关系开始或结束的日期与时间。
实现可以使用为描述关系而开发的现有词汇集，或者根据其特定实现的要求创建自己的词汇集。现有的词汇集包括 “Friend of a Friend” 与 “Relationship” 词汇集。
5.7 来源与目标
Activity 的 origin（来源）与 target（目标）属性分别标识动作源自的实体与指向的实体。例如，在英文语句“Sally moved the file from Folder A to Folder B”（Sally 将文件从文件夹 A 移动到文件夹 B）中，
origin 是“文件夹 A”，target 是“文件夹 B”。此活动在下面的示例中说明：
示例 159
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Sally 将销售数据从文件夹 A 移动到了文件夹 B",
"type": "Move",
"actor": "http://sally.example.org",
"object": {
"type": "Document",
"name": "销售数据"
},
"origin": {
"type": "Collection",
"name": "文件夹 A"
},
"target": {
"type": "Collection",
"name": "文件夹 B"
}
}
origin 属性适用于任意类型的活动，只要英语介词“from”可用于标识活动 object（对象）的起源、来源或出处。
target 属性适用于任意类型的活动，只要英语介词“to”可用于标识活动 object（对象）的间接宾语或目的地。
