为什么使用 Kontakt
如果你想让作品和社区深度联动,例如:
制作每个人的专属游戏存档,而不是用一个存档码
获得当前玩家的社区公开信息,例如名字, id, 关注了多少人, 有多少粉丝等等
获得当前项目的投币数、评论数、收藏数等等
让用户投币
让玩家可以自动截取当前游戏画面并且发到评论中(例如 100 种奇怪的死法)
当前玩家是否点赞或者收藏了另一个作品
跳转到 CCW 的其他页面
🚨
注意:由于 Kontakt 中的 API 可能会打扰到玩家, 请严格地遵循以下使用协议:🚨Kontakt API 使用协议
模块Kontakt 分为 4 个大模块,分别功能如下:
模块 介绍 粉丝和当前用户 1. 判断当前用户是否是是粉丝
2. 当前玩家是另一个用户的粉丝么
3. 用户的 Id,星座,性别等等公开信息
4. 当前用户是作者的粉丝么 当前项目 1. 当前用户是否点赞?投币了多少?
2. 让用户投某个数量的币,并且等待是否成功?
3. 获得当前项目的评论数、收藏数、点赞数和获得的总投币数
4. 让用户发评论,并且可以设定是否带舞台区的截图 其他项目 1. 当前用户点赞了或者收藏了某个项目么? 网站相关 用于游戏内邀请玩家一起玩,或者让用户点击进入游戏时有特别的功能
1. 跳转到 CCW 中的某个地址
2. 向网址中写入内容(参数),以及获取网址中的(参数)
🚨
测试插件时请注意!!! 在编辑器模式下(源码的界面),所有调用的数据都是模拟值。 这会便于肝酱开发和测试功能。 例如,使用投币并判断成功时,调用后不会实际扣除金币。
🚫
向用户授权时请注意: 所有需要用户同意的请求,在 1 分钟内不能调用超过 4 次。 也就是说当用户在一分钟之内取消授权 4 次后, 若程序还在不停的请求,将会默认得到 false,并且不再向用户弹窗确认。 只有在所有的尝试请求停止 1 分钟之后,重新请求时才会问用户要授权。
其中填写的内容是用户的 唯一 Id 或者 共创 Id (任意一种都可以)。
Id 类型 获取方法 典型数值 唯一 Id 在某个人的个人主页网址中,例如:
https://www.ccw.site/student/59fff36eefd0bf7679686631 ,其中【59fff36eefd0bf7679686631】这部分是唯一 Id 59fff36eefd0bf7679686631 共创 Id 在某个人的个人主页的个人档案一栏, 可以看到共创世界 ID。例如 199460496 就是 yk1boy 的 共创 Id 199460496
其中可以选择的信息和定义如下:
属性 描述 典型值 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
例如,如果想绘制当前的用户名和头像到舞台,可以结合高级画笔这样写
注意,所有在模块中带 🔑 的积木,都会由共创弹窗征求用户同意。例如这个模块调用后,会弹出这样的提示,在用户点击按钮前,程序都会被卡住在这条积木上。用户点击后程序继续。
当用户选择不同意时,返回 false。
当前项目相关代码当前用户已对此作品点赞当前用户在当前作品下投了多少币。注意,此数据会有不超过 5 分钟的延迟。 也就是说,马上投币的话,马上调用这个积木是不能获得真实数值的。
让用户投币多少枚,用户会收到请求投币的确认窗口。 当用户选择同意时,返回 true,当用户不同意,或者投币异常(例如不够了)时,返回 false。
执行后会弹出以下窗口让用户确认:
获得项目的评论数、收藏数、点赞数或获得的投币数。
评论发送发送评论,并且可以选择截取的舞台区的内容发送到评论区。
运行后,会需要用户对内容进行确认:
肝酱可以获得当前用户是否点赞了,或者收藏了某个项目
以地址 https://www.ccw.site/detail/62c58510e5ef5e76ba7e1450?inviteCode=gEyNXr72zQlvMd5v 为例,其中项目 Id 为链接的这个部分: 62c58510e5ef5e76ba7e1450
❌ 注意: 在权限方面,获得其他项目的权限要求会更严格:
例如: A 创作者创作了 a1 这个作品。 B 创作者创作了 b1 这个作品。 a1 作品中尝试获得玩家 C 是否为作品 b1 点赞或者收藏。 只有在 B 创作者关注了 A 时,或者 A 和 B 互为粉丝时。 才能获得真实的点赞收藏情况。 否则都会返回 false。
网站相关跳转到某个 CCW 地址注意,在内容中填写的任何地址,会自动去掉网址部分。以下情况:
输入值 实际跳转地址 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
调用第一个积木的时候,会生成把 data 编码到网址的地址。 例如:
https://ccw.site/detail/62c58510e5ef5e76ba7e1450?kontakt=******
第二个积木执行时会获得 ****** 对应解码的数值。
例如可以组合这样使用:
注意: 编码的内容长度不超过 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