探秘交互叙事的未来:inkjs - 编程语言ink的JavaScript实现
inkjs是一款强大的JavaScript库,它将inkle的交互式叙事脚本语言ink移植到Web环境中。这款库完全兼容原版ink,无任何依赖性,并可在所有浏览器和Node.js环境中流畅运行。立即尝试在线演示,感受inkjs的魅力!
安装与启动
只需通过npm执行npm install inkjs
即可安装。如果你不使用npm,也可以直接从此处下载最新版本的文件,然后在HTML中添加一个script标签即可。
快速开始?利用服务器端模板,在story.js
中替换示例故事,打开index.html
,你的inkjs之旅就开始了!
inkjs提供全局对象inkjs
,其中的Story
属性是主要操作接口。创建新故事就像调用var story = new inkjs.Story(storyContent);
一样简单。
与JSON文件协同工作
频繁更新故事内容?考虑使用JSON文件存储你的故事。但请注意,由于浏览器的CORS政策,你需要一个Web服务器来加载JSON。你可以借助node.js或Python轻松搭建服务器。
使用Node.js
在Node.js环境下,可以参考模板代码,用require
或fs
加载JSON文件。准备好故事对象和JSON文件后,只需要像这样启动故事:
var inkStory = new Story(json);
console.log(inkStory.ContinueMaximally());
inkjs独特之处
inkjs与C# API有微小差异,例如:
- 无法直接读写变量(不支持ES2015 Proxy的环境)时,需使用
$
函数。 - 调用
EvaluateFunction
获取输出文本时,需传递额外参数以捕获输出。
此外,inkjs还提供了TypeScript支持和自定义编译器,方便你在项目中更好地集成和管理故事内容。
应用场景广泛
inkjs适用于各种需要交互叙事的应用:
- 角色扮演游戏中的剧情分支
- 决策驱动的游戏
- 教育软件中的互动学习体验
- 创意写作工具
- 文本冒险游戏
inkjs的特点包括:
- 全面兼容ink脚本语言
- 零依赖,跨平台
- 强大的TypeScript支持
- 提供独立编译器,便于集成到现有工作流中
无论是游戏开发者,还是想要探索交互叙事的新手,inkjs都是一个值得信赖的工具。立即加入inkjs社区,开启你的创新故事创作旅程吧!