91 lines
4.1 KiB
Markdown
91 lines
4.1 KiB
Markdown
# プラグインの作成
|
||
Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。
|
||
ここではプラグインの作成にあたってのメタデータ定義や、AiScript APIリファレンスを掲載します。
|
||
|
||
## メタデータ
|
||
プラグインは、AiScriptのメタデータ埋め込み機能を使って、デフォルトとしてプラグインのメタデータを定義する必要があります。
|
||
メタデータは次のプロパティを含むオブジェクトです。
|
||
|
||
### mame
|
||
プラグイン名
|
||
|
||
### author
|
||
プラグイン作者
|
||
|
||
### version
|
||
プラグインバージョン。数値を指定してください。
|
||
|
||
### description
|
||
プラグインの説明
|
||
|
||
### permissions
|
||
プラグインが要求する権限。MisskeyAPIにリクエストする際に用いられます。
|
||
|
||
### config
|
||
プラグインの設定情報を表すオブジェクト。
|
||
キーに設定名、値に以下のプロパティを含めます。
|
||
|
||
#### type
|
||
設定値の種類を表す文字列。以下から選択します。
|
||
string number boolean
|
||
|
||
#### label
|
||
ユーザーに表示する設定名
|
||
|
||
#### description
|
||
設定の説明
|
||
|
||
#### default
|
||
設定のデフォルト値
|
||
|
||
## APIリファレンス
|
||
AiScript標準で組み込まれているAPIは掲載しません。
|
||
|
||
### Mk:dialog(title text type)
|
||
ダイアログを表示します。typeには以下の値が設定できます。
|
||
info success warn error question
|
||
省略すると info になります。
|
||
|
||
### Mk:confirm(title text type)
|
||
確認ダイアログを表示します。typeには以下の値が設定できます。
|
||
info success warn error question
|
||
省略すると question になります。
|
||
ユーザーが"OK"を選択した場合は true を、"キャンセル"を選択した場合は false が返ります。
|
||
|
||
### Mk:api(endpoint params)
|
||
Misskey APIにリクエストします。第一引数にエンドポイント名、第二引数にパラメータオブジェクトを渡します。
|
||
|
||
### Mk:save(key value)
|
||
任意の値に任意の名前を付けて永続化します。永続化した値は、AiScriptコンテキストが終了しても残り、Mk:loadで読み取ることができます。
|
||
|
||
### Mk:load(key)
|
||
Mk:saveで永続化した指定の名前の値を読み取ります。
|
||
|
||
### Plugin:register_post_form_action(title fn)
|
||
投稿フォームにアクションを追加します。第一引数にアクション名、第二引数にアクションが選択された際のコールバック関数を渡します。
|
||
コールバック関数には、第一引数に投稿フォームオブジェクトが渡されます。
|
||
|
||
### Plugin:register_note_action(title fn)
|
||
ノートメニューに項目を追加します。第一引数に項目名、第二引数に項目が選択された際のコールバック関数を渡します。
|
||
コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。
|
||
|
||
### Plugin:register_user_action(title fn)
|
||
ユーザーメニューに項目を追加します。第一引数に項目名、第二引数に項目が選択された際のコールバック関数を渡します。
|
||
コールバック関数には、第一引数に対象のユーザーオブジェクトが渡されます。
|
||
|
||
### Plugin:register_note_view_interruptor(fn)
|
||
UIに表示されるノート情報を書き換えます。
|
||
コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。
|
||
コールバック関数の返り値でノートが書き換えられます。
|
||
|
||
### Plugin:register_note_post_interruptor(fn)
|
||
ノート投稿時にノート情報を書き換えます。
|
||
コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。
|
||
コールバック関数の返り値でノートが書き換えられます。
|
||
|
||
### Plugin:open_url(url)
|
||
第一引数に渡されたURLをブラウザの新しいタブで開きます。
|
||
|
||
### Plugin:config
|
||
プラグインの設定が格納されるオブジェクト。プラグイン定義のconfigで設定したキーで値が入ります。
|