如果你想查看 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	`你之所以在删除所有拓展的积木后重新加载却无法彻底删除拓展，可能是因为拓展相关内容被写到了monitor中，即使它被隐藏。`

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	共创世界:小红板

名字	说明
semver	Scratch的版本(不确定)
vm	Scratch vm的版本(不确定)
agent	浏览器UA

SAE json分析