Skip to content

wangzongjun/ScratchJr

Repository files navigation

我们是一群Scratch爱好者,感谢Scratch提供了非常棒的少儿编程工具。 ScratchJr是Scratch官方提供的面向5-7岁儿童,学习Scratch的入门工具。相比较Scratch而言,ScratchJr更加适合初学者。

官方开源地址ScratchJr,官方提供了iPad和Android平板版本。

jfo8000提供了window 和 Mac版本,安装后就可以体验ScratchJr。

我们的目标是把ScratchJr修改为网页版本,在浏览器中就可以体验ScratchJr,同时保持与官方版本的兼容。

当前版本计划:

1.1版本计划 -- 【2021年4月22日发布】

  1. 角色和背景支持自定义[添加、删除、搜索、编辑]以及分类,使用说明请查看网页“mediaHelp.html”
  2. 增加新积木块:水平镜像
  3. 配置音效积木块,使用步骤 (1. )将音效文件,存放在 assets/sound/ 目录下 (2. )在media.json文件的sounds中增加音效的名称,格式如下:"sounds":["pop.mp3","接收.mp3"] (3. )上传assets/sound/下新增加的音效 和 media.json文件到服务器

1.2版本计划 -- 【预计:2021年5月底发布】

  1. 修改svg格式显示的Bug;
  2. 修改画画板在Firefox浏览器上的错误
  3. 修改SVG无法拖放的Bug
  4. 修改角色比较多的情况下,角色列表太小的问题
  5. 其他Bug

1.3版本计划-- 【预计:2021年6月底发布】

  1. 增加“教室或者班级管理”功能

与官方保持同步,目前更新到官方2020-9-14版本,这个版本的主要修改:

  1. 统一iOS 和 Android与JS交互的接口,具体的见tablet\OS.js
  2. 升级iOS底层,不再使用iOS已经废弃的WebView,使用新的WKWebView。
  3. 增加新的国际化语言

官方版本只考虑了iOS 和 Andorid,对网页支持的并不好,主要体现在以下几个方面:

  1. 事件点击:官方版本点击事件使用的是ontouchstart/ontouchmove/ontouchend,网页版本在此基础上增加了onmousedown/onmousemove/onmouseup,详细修改见 utils/lib.js
  2. 数据存储:官方调用的是iOS 和 Andorid底层的API,iOS主要是sqlite数据库接口,网页版本使用localForage实现数据存储功能。
  3. 录音/录制视频、声音播放功能:官方调用的是iOS 和 Andorid底层的API,网页版本使用recordrtc实现录制功能,使用soundmanager2实现声音播放功能,详细说明见tablet\Web.js;

tablet底层接口简要说明,目前包括三个平台:

  1. Adnroid.js:js调用Android底层API
  2. iOS.js:js调用iOS底层API
  3. WebOS.js:调用网页相关功能

在**OS.waitForInterface()**中获取平台相关信息,调用对应的平台。

使用

window.JrConfig对象

scratchJr的配置,需要载入编辑器之前完成

window.JrConfig = {
    //点击保存到云端按钮
    onSaveCloud: function(contents, name){
        //contents: sjr项目文件
        //name: 作品名称
    }
}

window.ScratchJr对象

scratchjr对外暴露的接口

//获取作品文件
window.ScratchJr.getProjectSjr((contents, name)=>{
    //contents: sjr项目文件
    //name: 作品名称
});
//获取作品封面
window.ScratchJr.getProjectCover((cover)=>{
    //cover:base64封面
});

//从URL加载sjr项目文件
window.ScratchJr.loadProjectSjr(url);