# AiScript

AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。

- [プラグイン](./plugin/)
- [ウィジェット](/docs/for-users/features/widgets/)
  - ボタン
  - AiScriptコンソール
  - AiScript App
- Misskey Play
- スクラッチパッド

:::tip

AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。

:::

## 使い方

AiScript標準の構文や組み込み関数などが使用できます。

:::tip

ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\
Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。

:::

これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。

### Misskey AiScript API

接頭辞: `Mk:`\
Misskey内の全てのAiScript環境で使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。

### プラグインAPI

接頭辞: `Plugin:`\
[プラグイン](./plugin/)でのみ使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。

### UI API

接頭辞: `Ui:`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。
ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。

### 標準入出力

AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。

#### readline(message)

`message`: `str`\
返り値: `str`\
Misskey内の全てのAiScript環境で使用できます。\
\
文字列の入力を求めるポップアップを表示します。

#### print(message)

`message`: `any`\
返り値: `null`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\
\
コンソールに文字列を出力します。\
\
`<:`構文も同様の働きをします。