SAE json分析
如果你想查看 tnode
和 tdata
中内容的格式,请查看 SAE-data.md
怎么使用
SAE.json.load
载入json文本,返回作品的编号
SAE.json.debug(编号)
输出编号为起点的结构树
SAE.options._OrigInputType
显示输入区的编号,仅供调试使用,会显示输入的数字类型,但同时会导致分析出错。(查找 InputType 了解更多)
Scratch JSON 文件的构成
Scratch 的 JSON 文件最外层是一个对象,有四个属性:
{"targets":[...],"monitors":[...],"extensions":[...],"meta":{...}}
名字 | 说明 |
---|---|
targets | 背景和角色 |
monitors | 变量在舞台上的显示 |
extensions | 使用的拓展 |
meta | 创作作品的工具的说明 |
targets
targets是一个包含了n个对象的数组。"targets":[{...},{...},...]
每一个对象的属性:
(!:只有舞台才有 !!:只有角色才有 ?:后面有详细说明)
名字 | 说明 |
---|---|
isStage | 是否为舞台 |
name | 角色名字(舞台为Stage ) |
variables | ?变量列表(如果是舞台,则为共用变量) |
lists | ?列表列表(如果是舞台,则为共用列表) |
broadcasts | ?广播列表 |
blocks | ?积木列表 |
comments | ?注释列表 |
currentCostume | 当前造型编号(0开始) |
costumes | ?造型列表 |
sounds | ?声音列表 |
volume | 当前音量(舞台,角色都有!) |
layerOrder | ! 层叠顺序(越小越后) |
tempo | ! 演奏拍子数(拓展:音乐) |
videoState | ! 摄像头是否开启(拓展:视频侦测) |
textToSpeechLanguage | ! 文本转语音语言(拓展:文本朗读) |
visible | ! 是否显示 |
x | !! x坐标 |
y | !! y坐标 |
size | !! 大小 |
direction | !! 方向 |
draggable | !! 可拖动? |
rotationStyle | !! 旋转模式 |
variables,lists
变量列表为一个对象,表示角色、舞台里的变量。
"variables":{"变量id":["变量名","数值"],...}
变量id - 系统自动生成的变量id,一般是20个字符。也有例外,例如“我的变量”
变量名:变量的名字
数值:变量的数值
列表同理,只是数值变成了列表。
broadcasts
"broadcasts":{"广播id":"广播名",...}
广播列表的结构和变量差不多,就是没有数值的变量。表示角色、舞台内使用的广播。
这个列表目前在处理时没有任何用处。因为处理时直接读取积木。
costumes,sounds
costumes和sounds是一个包含了n个对象的数组。"costumes":[{...},{...},...]
"sounds":[{...},{...},...]
每一个对象的属性:
(!:只有costumes才有 !!:只有sound才有)
名字 | 说明 |
---|---|
name | 造型/声音的名字 |
assetId | 造型/声音的包内文件名(一般是文件md5+原拓展名) |
md5ext | 和assetId一样 |
dataFormat | 文件拓展名 |
bitmapResolution | ! 位图分辨率(表示图像会被缩小到几分之一) |
rotationCenterX | ! 图片旋转中心x坐标 |
rotationCenterY | ! 图片旋转中心y坐标 |
format | !! 不知道! |
sampleCount | !! 声音采样数 |
rate | !! 声音采样率 (sample/rate=声音长度(秒) |
comments
comments是一个包含了很多注释对象
的对象。
"comments":{"注释id":{...},...}
每一个注释对象的属性:
名字 | 说明 |
---|---|
blockId | 注释连接到的积木id(null:没链接到积木的注释) |
x | x坐标 |
y | y坐标 |
width | 宽度 |
height | 高度 |
minimized | 注释是否折叠 |
text | 注释文本 |
blocks
blocks是一个包含了很多积木对象
的对象。
"blocks":{"积木id":{...},...}
积木对象的格式比较复杂。? 表示后面会详细说明
名字 | 说明 |
---|---|
opcode | ?积木的类型(例如motion_gotoxy 代表移动到 x: () y: () ) |
next | 下一个积木的id(null表示没有) |
parent | 上一个(或者,外面一层的)积木的id(null表示没有) |
inputs | ?输入的数字和放入的积木 |
fields | ?选择的下拉选项 |
shadow | 是否为可拖出的积木(例如造型选项即为不可拖出的积木) |
toplevel | 是否处于最前面(parent等于null) |
x | x坐标(只在最前面的积木出现) |
y | y坐标(只在最前面的积木出现) |
mutation | ?积木变体信息 |
需要注意的是还有一种特殊情况,在有变量和列表单独出现(没有连在其他积木上)时,
“积木id”后还可能会出现数组[…],需要特别留意,其格式如下:
[输入类型,数值,相关id,x坐标,y坐标]
可以参见 inputs 中的说明。
opcode
opcode是表示积木的类型,一般由类型名_操作名
组成。
例如 motion_gotoxy
就表示 motion
(运动) 类型下的 gotoxy
动作。移动到 x: () y: ()
可以在 SAE-disp-table.js 中找到积木类型与积木显示之间的对照表。
关于类型与拓展列表,可以参考 extensions.
inputs
"inputs":{"输入名1":[...],"输入名2":[...],...}
输入名:代表参数的名字,例如在积木motion_movesteps
中STEPS
表示步数
SAE 没有检测参数的名字,而是假设它们以一定的顺序出现,因此在SAE-disp-table.js中参数都用1,2,3…编号。这并不严谨。
不过也有例外,在”如果”,”不成立”这类要拖入六边形积木和其它积木组的时候参数将会按照拖入的顺序进行排序,如果没有拖入还会消失。
这时就需要通过检测输入名的最后一个字符(偷懒)来判断参数的位置。
例如”如果”control_if
中有两个参数:CONDITION
和SUBSTACK
,那么就把它在特殊(需要特殊关照的)积木列表blockspecs
中标记"#control_if", "NK",
就表示 control_if
中有两个参数,最后一个字母分别是N
和K
。
然后是[…]里的内容,是这样:
[类型编号,参数1]
或者 [类型编号,参数1,参数2]
注意参数1,参数2中既可能有文本或者数字,也可能有与[类型编号,参数1,参数2]
相似的结构,例如
[1, [12, "x", "XzZ3_=u+7z5o#CUVg4,_"], "10"]
像这种参数中也有 [类型编号,参数1,参数2]
类型编号的情况,在下面的表格中会用[类型x]来代替
我总结了一下大概是这样:
编号 | 参数1 | 参数2 | 说明 |
---|---|---|---|
1 | [积木id] 或 [类型x] | 无 | 普通的白色空或者圆形选项,内容是参数1的数值 |
2 | [积木id] 或 null | 无 | 六边形填入或者C,E形积木中的积木组的填入,参数1表示填入的积木id(null表示未填入) |
3 | [积木id] 或 [类型x] | [积木id] 或 [类型x] | 填入积木的白色空或者圆形选项,参数1为填入的积木,参数2为原来的白色空或者选项 |
4 | 数字 | 无 | !能填入任意数字的白色空 |
5 | 大于零的数字 | 无 | !能填入任意大于零的数字的白色空 |
6 | 正整数 | 无 | !能填入任意正整数的白色空 |
7 | 正整数 | 无 | !能填入任意正整数的白色空(列表序号专用) |
8 | 表示角度的数字 | 无 | 能填入表示角度的数字的白色空(大于-180,不超过180) |
9 | 颜色 | 无 | 能选择颜色的空 |
10 | 文本 | 无 | 能填入任意文本的白色空 |
11 | 广播名字 | 无 | 能选择广播名字的选项 |
12 | 变量名 | [变量id] | 引用变量 |
13 | 列表名 | [列表id] | 引用列表 |
标了 ! 的积木在电脑上这些没啥区别,你可以想输入什么数字就输入什么数字,但是在手机上点击这些空会弹出有限按钮的输入小键盘,会有区别。
例如整数输入时没有.号,正整数输入时没有-号
fields
fields比较简单。
"fields":{"输入名1":[...],"输入名2":[...],...}
输入名和 inputs 差不多。除了没有特殊情况之外。
[…]的语法也变简单了,具体是 ["文本",指向id]
, 其中指向id 表示文本指向的项目id
(如果文本是变量名,那么id就是相对应的变量id;如果文本是广播名,那么指向id 表示文本指向的广播id;如果没有合适的id则会显示null。
mutation
这一个比较少用,表示积木变体。常见于 procedures_prototype
和 procedures_definition
中。
"mutation":{...}
?:只在 control_stop
中有 !: 在procedures_prototype
和 procedures_call
中有 !!:只在 procedures_prototype
中有
名字 | 说明 |
---|---|
tagName | 文本”mutation” |
children | 空数组[] |
hasnext | ? 能否在后面连接积木(选择停止该角色的其他脚本 时为true ) |
proccode | ! 积木定义代码(%s表示文本,%b表示条件,%n表示数字) |
argumentids | ! 参数的id |
argumentNames | !!参数的名字(其实你可以在这个积木的inputs里面获取) |
argumentdefaults | !!参数默认值 |
warp | ! 运行时不刷新屏幕 |
monitors
monitors 用于表示舞台上的变量显示。
"monitors":[{...},{...},...]
名字 | 说明 |
---|---|
id | 类型 |
mode | 显示模式 |
opcode | 显示类型(类型名_操作名 ) |
params | 参数 |
spriteName | 角色名(null:舞台) |
value | 当前数值 |
width | 宽度 |
height | 高度 |
x | x坐标 |
y | y坐标 |
visible | 是否显示 |
sliderMin | 滑块最小值 |
sliderMax | 滑块最大值 |
isDiscrete | 是否允许滑块选择小数 |
id,opcode
id的功能应该只是区分不同的monitors,但是既然它与opcode有一点关联那不妨也提一下
[角色id]为随机生成,目前没看到它在除monitors之外的地方出现。
[参数NUMBER_NAME] 指params参数中参数NUMBER_NAME的值
edit: id放在后面
如果你使用文本编辑器打开,请忽略下面的\号
id | opcode | 说明 |
---|---|---|
loudness | sensing_loudness | 响度 |
[列表id] | data_listcontents | 列表,参数 LIST: 列表名 |
[角色id]_xposition | motion_xposition | x坐标 |
[角色id]_yposition | motion_yposition | y坐标 |
[角色id]_direction | motion_direction | 方向 |
[角色id]_costumenumbername_[参数NUMBER_NAME] | looks_costumenumbername | 造型[名称/编号],参数 NUMBER_NAME: number 编号 name 名称 |
backdropnumbername_[参数NUMBER_NAME] | looks_backdropnumbername | 背景[名称/编号],参数 NUMBER_NAME: number 编号 name 名称 |
[角色id]_volume | sound_volume | 音量 |
answer | sensing_answer | 回答 |
timer | sensing_timer | 计时器 |
current_[参数CURRENT_MENU小写] | sensing_current | 当前时间,参数 CURRENT_MENU: YEAR年, … |
sensing_username | sensing_username | 用户名 |
[变量id] | data_variable | 变量,参数 VARIABLE: 变量名 |
music_getTempo | music_getTempo | 音乐演奏速度 |
translate_getViewerLanguage | translate_getViewerLanguage | 翻译:访客语言 |
目前还未收录硬件拓展和非原生sc拓展。
mode
名字 | 说明 |
---|---|
default | 普通 |
large | 大字 |
slider | 滑块 |
list | 列表 |
1 |
|
extensions
表示作品中使用的拓展的列表。
"extensions":[...]
已支持的拓展:
名字 | 说明 |
---|---|
music | 音乐 |
pen | 画笔 |
videoSensing | 视频侦测 |
text2speech | 文字朗读 |
translate | 翻译 |
makeymakey | Makey Makey |
tw | TurboWarp |
lazyaudio | 稽木世界:LazyAudio |
canvas | 稽木世界:Canvas |
stringExt | 稽木世界:String Extension |
js | 稽木世界:JavaScript |
community | 稽木世界:Community |
puzzle | 稽木世界:Puzzle |
kinect | 稽木世界:Kinect |
community | 共创世界:社区(虽然和 稽木世界 用的是一个单词) |
lazyMusic | 共创世界:音乐懒加载 |
text | 艺术字 |
faceSensing | 面部识别 |
box2d | 物理引擎 |
redBoard | 共创世界:小红板 |
meta
表示编辑器的信息。
名字 | 说明 |
---|---|
semver | Scratch的版本(不确定) |
vm | Scratch vm的版本(不确定) |
agent | 浏览器UA |