.svg){kind=small}
为什么使用 Kontakt
如果你想让作品和社区深度联动，例如：
- 制作每个人的专属游戏存档，而不是用一个存档码
- 获得当前玩家的社区公开信息，例如名字， id， 关注了多少人， 有多少粉丝等等
- 获得当前项目的投币数、评论数、收藏数等等
- 让用户投币
- 让玩家可以自动截取当前游戏画面并且发到评论中（例如 100 种奇怪的死法）
- 当前玩家是否点赞或者收藏了另一个作品
- 跳转到 CCW 的其他页面
模块
Kontakt 分为 4 个大模块，分别功能如下：
模块 | 介绍 |
粉丝和当前用户 | 1. 判断当前用户是否是是粉丝
2. 当前玩家是另一个用户的粉丝么
3. 用户的 Id，星座，性别等等公开信息
4. 当前用户是作者的粉丝么 |
当前项目 | 1. 当前用户是否点赞？投币了多少？
2. 让用户投某个数量的币，并且等待是否成功？
3. 获得当前项目的评论数、收藏数、点赞数和获得的总投币数
4. 让用户发评论，并且可以设定是否带舞台区的截图 |
其他项目 | 1. 当前用户点赞了或者收藏了某个项目么？ |
网站相关 | 用于游戏内邀请玩家一起玩，或者让用户点击进入游戏时有特别的功能
1. 跳转到 CCW 中的某个地址
2. 向网址中写入内容（参数），以及获取网址中的（参数） |
方法及定义
粉丝和当前用户
当前用户是作者的粉丝么？
.svg){kind=small}
当前用户是某个作者的粉丝么？
.svg){kind=small}
其中填写的内容是用户的 唯一 Id 或者 共创 Id （任意一种都可以）。
Id 类型 | 获取方法 | 典型数值 |
唯一 Id | 在某个人的个人主页网址中，例如：
https://www.ccw.site/student/59fff36eefd0bf7679686631 ，其中【59fff36eefd0bf7679686631】这部分是唯一 Id | 59fff36eefd0bf7679686631 |
共创 Id | 在某个人的个人主页的个人档案一栏， 可以看到共创世界 ID。例如 199460496 就是 yk1boy 的 共创 Id | 199460496 |
得到当前用户的公开信息
.svg.fixed.svg){kind=small}
其中可以选择的信息和定义如下：
属性 | 描述 | 典型值 |
Id | 共创 Id | 199460496 |
名字 | 在共创的昵称 | yk1boy |
唯一 Id | 唯一 UUID | 59fff36eefd0bf7679686631 |
头像图片地址 | 用户的头像地址。 可用于在 Canvas 中绘制。 | https://m.xiguacity.cn/icon/new_avatar.png?x-oss-process=image%2Fresize%2Cs_150%2Fformat%2Cwebp |
星座 | 星座的编号，定义如下：
1: 水瓶
2: 双鱼
3: 白羊
4: 金牛
5: 双子
6: 巨蟹
7: 狮子
8: 处女
9: 天秤
10: 天蝎
11: 射手
12: 魔羯 | 12 |
关注了多少人 | 当前用户关注了多少人 | 100 |
粉丝数 | 当前用户获得了多少人关注 | 100 |
被点赞数 | 当前用户作品被点赞的次数 | 100 |
性别 | -1: 用户设置了隐藏
0: 男
1: 女 | -1 |
例如，如果想绘制当前的用户名和头像到舞台，可以结合高级画笔这样写
.svg.fixed.svg)
请求用户成为粉丝
.svg){kind=small}
注意，所有在模块中带 🔑 的积木，都会由共创弹窗征求用户同意。例如这个模块调用后，会弹出这样的提示，在用户点击按钮前，程序都会被卡住在这条积木上。用户点击后程序继续。
当用户选择不同意时，返回 false。
当前项目相关代码
当前用户已对此作品点赞
.svg){kind=small}
当前用户投币数
当前用户在当前作品下投了多少币。注意，此数据会有不超过 5 分钟的延迟。 也就是说，马上投币的话，马上调用这个积木是不能获得真实数值的。
.svg){kind=small}
让用户投币
.svg){kind=small}
让用户投币多少枚，用户会收到请求投币的确认窗口。 当用户选择同意时，返回 true，当用户不同意，或者投币异常（例如不够了）时，返回 false。
执行后会弹出以下窗口让用户确认：
项目的数据
.svg.fixed.svg){kind=small}
获得项目的评论数、收藏数、点赞数或获得的投币数。
评论发送
发送评论，并且可以选择截取的舞台区的内容发送到评论区。
.svg.fixed.svg)
运行后，会需要用户对内容进行确认：
其他项目
肝酱可以获得当前用户是否点赞了，或者收藏了某个项目
.svg){kind=small}
.svg){kind=small}
以地址 https://www.ccw.site/detail/62c58510e5ef5e76ba7e1450?inviteCode=gEyNXr72zQlvMd5v 为例，其中项目 Id 为链接的这个部分： 62c58510e5ef5e76ba7e1450
❌ 注意： 在权限方面，获得其他项目的权限要求会更严格：
例如： A 创作者创作了 a1 这个作品。 B 创作者创作了 b1 这个作品。 a1 作品中尝试获得玩家 C 是否为作品 b1 点赞或者收藏。 只有在 B 创作者关注了 A 时，或者 A 和 B 互为粉丝时。 才能获得真实的点赞收藏情况。 否则都会返回 false。
网站相关
跳转到某个 CCW 地址
.svg)
注意，在内容中填写的任何地址，会自动去掉网址部分。以下情况：
输入值 | 实际跳转地址 |
detail/624d6e17a0c3b17a0b7a58ee | https://ccw.site/detail/624d6e17a0c3b17a0b7a58ee |
https://www.ccw.site/detail/624d6e17a0c3b17a0b7a58ee?inviteCode=ql1Nblpk31IM9TDJ | https://www.ccw.site/detail/624d6e17a0c3b17a0b7a58ee?inviteCode=ql1Nblpk31IM9TDJ |
https://www.bilibili.com/video/BV1Bv4y13776?share_source=copy_web | https://ccw.site/video/BV1Bv4y13776?share_source=copy_web&vd_source=7944e06c7caffd29099fa77c1ef7281f |
https://ccw.site/mmo | https://ccw.site/mmo |
把数据编码到网址中，并且读取网址中的数据
.svg){kind=small}
.svg){kind=small}
调用第一个积木的时候，会生成把 data 编码到网址的地址。 例如：
https://ccw.site/detail/62c58510e5ef5e76ba7e1450?kontakt=******
第二个积木执行时会获得 ****** 对应解码的数值。
例如可以组合这样使用：
.svg)
注意： 编码的内容长度不超过 50 字符。 若超过 50 字符需要传输，需要用 数据助手插件组合使用。
Roadmap / Logs
版本 | 说明 |
1.0.1 | Hotfix:
解决了把请求投币等代码放入【等待】后的无限循环。并且限制了请求频率 |
1.0 | 增加了亿点点功能：
1. 扩展了更多的用户公开信息
2. 让用户投币的功能
3. 发送评论的功能
4. 当前用户对其他作品是否点赞或收藏
5. 把数据编码到 URL 上并解码
21.Juli.2022 Shawn |
0.3.3 | 初始版本
1. 是否是粉丝了？
2. 是否投币？
3. 用户的社区中的信息？
4. 跳转功能
Nick |