#author("2023-11-25T09:25:19+09:00","default:post","post")
#author("2023-11-25T09:30:25+09:00","default:post","post")
起動と終了に関するTIPS。

----
#contents
----
~

*基本 [#cb93d2d3]
ポストと狛犬では、概ね以下のように記述されています。

 *OnFirstBoot
 >初回
 
 *OnBoot
 >起動
 
 *OnClose
 >終了
 
 *OnGhostChanged
 >他のゴーストから変更
 
 *OnGhostChanging
 >他のゴーストへ変更

これにより、「*初回」「*起動」「*終了」といったトークが動作するようになります。

**栞イベントの解説 [#i2e602b5]

:OnBoot|ベースウェア(materia/SSP/CROW)起動時に、一番最初に呼び出されたゴーストが自分だった場合に使われます。 
 *OnBoot
 :いっちばーん。

:OnFirstBoot|そのゴーストが初めて起動した時に使われます。~
初めての起動ということで、他のイベントより優先されます。~
 *OnFirstBoot
 :はじめまして。

:OnGhostChanged|他のゴーストから交代した時に使われます。(R0)に、先に立っていたゴーストの名前が入ります。~
 *OnGhostChanged
 :(R0)さんから交代しました。

:OnGhostCalled|ベースウェアがSSPのみ、他のゴーストに呼び出されて同時起動した時に使われます。(R0)に、呼び出したゴーストの名前が入ります。~
特に何も設定していない場合、代わりにOnBootが使われます。
 *OnGhostChanged
 :(R0)さんに呼び出されました。

:OnGhostChanging|他のゴーストに交代する時に使われます。(R0)に、次に立つゴーストの名前が入ります。 ~
特に何も設定していない場合、代わりにOnCloseが使われます。
 *OnGhostChanging
 :(R0)さんに交代します。

:OnClose|ゴースト終了指示時に呼ばれます、OnGhostChangingで終了した場合や\-で終了する場合は呼ばれません。終了時トークを記載します。 
 *OnClose
 :おつかれさまでした。


*初回起動 [#n12c910f]
そのゴーストが初めて起動した時に呼ばれる、OnFirstBootイベントに記述します。~
前述したとおり、ポストと狛犬では「初回」という名前のトークにジャンプさせています。~
名前を変えても構いませんし、処理を追加したりするのもいいでしょう。

 *OnFirstBoot
 >初回
 
 *初回
 :(0)はじめましてだね。よろしく。

一度バニッシュ(アンインストール)された後、再びインストール後の初回起動では、Reference0に情報が追加されています。活用すると以下のような事もできます。
 
 *OnFirstBoot
 >消され経験あり初回【タブ】(R0)>0
 >初回
 
 *消され経験あり初回
 :(8)一度消したくせに、また来たの?

**初回起動イベント [#tfdeec00]
初回起動ではゴーストの取り扱いや状況といった基本的な説明を行うことが多いでしょう。~
しかし、初回起動といえども扱いは普通のトークと同じです。~
''そのままではマウス反応などの新たなイベントで上書きされてしまう状態''のため、誤操作で本体をクリックしてしまったり、SSPを終了させてしまった場合、説明を十分にできないまま次の段階へ進んでしまうといったことが有り得ます。~
OnFirstBootは、一度でも起動したら、以後アンインストールするまで二度と発生しないためです。~
初回起動でユーザーの名前まで覚えさせるゴーストも多いですから、それもスキップされてしまいます。

-対策の一例。~
関連記事として、 [[重要トークを作る時の工夫と配慮]] と [[名前を覚えさせる]] も併せて読んで下さい。

 *OnFirstBoot
 >初回
 
 *OnBoot
 >初回【タブ】(変数「初回イベントを完遂」の存在)==0
 >起動
 
 *初回
 :\t(0)はじめまして。
 ...
 #中略
 ...
 では(ユーザ名)さん、よろしくお願いします。\x
 \![raise,初回イベント完了]
 
 *初回イベント完了
 $初回イベントを完遂【タブ】1

この例では「初回」トークを再生中にはマウス反応が起こらず、~
また、このトークが終わる前にSSPを終了した場合、次に起動した時も「初回」トークが流れます。~
ポイントはトークごとにさくらスクリプトの &color(red){\t}; を追加しておくこと。~
このスクリプトを冒頭で宣言しておくだけで、そのトークが流れている間はマウス反応などが起こらなくなります。~
そして最後に &color(red){\x \![raise,イベント名]}; を使うことで、イベントが終わったタイミングでフラグを立てます。~
(\xはバルーンをクリックするまで一時停止、\![raise]は実行したタイミングで新たなイベントを上書き発生させます。)

**分岐テクニック [#e3c784f7]
上の例は中途半端に終了したとき「さっきのはなかったことにしてもう一度初回トーク」という挙動です。~
そこでさらに発展させて、初回の最中に終了された時に専用のトークを使ってフォローをする方法も紹介。~
OnBootに少し手を加え、新たに中断された時のためのトークを追加します。

 *OnFirstBoot
 >初回
 
 *OnBoot
 >初回に中断された【タブ】(変数「初回イベントを完遂」の存在)==0
 >起動

 *初回に中断された
 :\tちょっとー。まだ説明が終わってないんですけど!
 まあいいや、もう一度説明するよ?
 ...
 #中略
 ...
 では(ユーザ名)さん、よろしくお願いします。\x
 \![raise,初回イベント完了]
 
 *初回イベント完了
 $初回イベントを完遂【タブ】1

こうすると、「OnFirstBootは経験済みだけど初回イベントが完了していない」時の処理になります。


**¥0と¥1の初期位置を入れ替える [#v9a78cb2]
-SSP専用

初回起動時には、\0側のキャラクターは右、\1側のキャラクターは左に表示されます。
しかし、シェルの向きの関係などで、左側にメインキャラクターを持っていきたい時もあるでしょう。~
他にも、デフォルトを始めとした多くのバルーンは\0側が大きく\1側が小さい、右クリックメニューは\0側に設定を始めとした多くの項目がある等、それぞれの差異から初期位置の入れ替えをしたいケースがあると思います。

SSPのプロパティシステムを使うと、\0と\1の初期位置を取得することができます。~
この値を参考に、さくらスクリプトのmoveを使えば両者を入れ替えることができます。~
ただし、ディスプレイの情報は環境依存(=個人個人で設定が固有)のため、あるユーザのところでだけ動かないなどが起こりえます。~
ある程度さくらスクリプトを理解している方向け。~

 *OnFirstBoot
 \![get,property,OnChangePosition,currentghost.scope(0).x,currentghost.scope(0).y,currentghost.scope(1).x,currentghost.scope(1).y]
 
 *OnChangePosition
 \0\![move,(R2),(R3),0,primaryscreen,left.top,center.bottom]φ
 \1\![move,(R0),(R1),0,primaryscreen,left.top,center.bottom]φ
 (初回)



*起動時刻で起動トークを変える [#h95f4cd6]
*起動(通常起動) [#m25e7991]
OnBootイベントの発生から呼び出される平時の起動イベントについて。

**起動時刻で起動トークを変える [#h95f4cd6]
 *OnBoot
 >起動
 
 *起動
 >深夜に起動【タブ】(現在時)<4
 >早朝に起動【タブ】(現在時)<6
 >朝に起動【タブ】(現在時)<10
 >昼に起動【タブ】(現在時)<16
 >夕方に起動【タブ】(現在時)<18
 >夜に起動【タブ】(現在時)<23
 >深夜に起動
 
 *深夜に起動
 :夜中だよ・・・
 
 *早朝に起動
 :ずいぶん早起きだね・・・
 
 *朝に起動
 :おはよー
 
 *昼に起動
 :こんちはー
 
 *夕方に起動
 :ちわーっス
 
 *夜に起動
 :こんばんわー
こんな感じで記述を。~
時間帯の区切りを変えたり細かくしたりいろいろできます。~
同じように、終了トークも時間帯によって変えられます。~

頻繁に使うのであれば、 
 @時間帯
 (iflist、(現在時)<、4、深夜、6、早朝、10、朝、
 16、昼、18、夕方、23、夜、深夜)
の二行を追加した上で、 

 *起動
 >(時間帯)に起動
とすると、それぞれの時間帯に飛ぶので楽です。 



*曜日によってトーク内容を変える [#t848cf0d]
**曜日によってトーク内容を変える [#t848cf0d]
 *起動
 >休日の場合【タブ】(現在曜日)==土||(現在曜日)==日
 >午前中に起動【タブ】(現在時)<12
 >午後に起動
 
 *休日の場合
 >休日の午前中【タブ】(現在時)<12
 :きょうは休日です。
 
 *休日の午前中
 :やすみの日くらいゆっくり寝かせてたもれ。



*第○何曜日かによって起動トークを変える [#fbfa2f52]
**第○何曜日かによって起動トークを変える [#fbfa2f52]
 *OnBoot
 $第○週=(when,(現在日)%7,(現在日)÷7+1,(現在日)÷7)
 $第○何曜日	第(第○週)(現在曜日)曜日
 >(現在月)月(第○何曜日)
 >起動
 
 *1月第2月曜日
 :今日は成人の日です。
 
 *5月第2日曜日
 :今日は母の日です。
 
 *7月第3月曜日
 :今日は海の日です。

上記のように記述をすると、何月の第○何曜日にイベントを起こすことができます。
また、 

 *OnBoot
 (第○週取得)
 $第○何曜日	第(第○週)(現在曜日)曜日
 >起動
 
 *1月第2月曜日
 :今日は成人の日です。
 
 *5月第2日曜日
 :今日は母の日です。
 
 *7月第3月曜日
 :今日は海の日です。
 
 @第○週取得
 (when,(現在日)%7,(set,第○週,(現在日)÷7+1),(set,第○週,(現在日)÷7))

のように記述することもできます。~
ただし、このときには第○週の数値が半角になるので注意が必要です。~


*起動時のトークを前回からの期間に応じて変える [#l645cdaa]
**起動時のトークを前回からの期間に応じて変える [#l645cdaa]
新たな記事にまとめました。~
→[[起動時のトークを前回からの期間に応じて変える]]

*起動イベントトークを1回だけ話す [#a47071ee]
正月やバレンタインなど様々な行事に対応した起動イベントがありますが、そういうトークは1回で十分!って人向け。2回目以降は通常起動、又は通常交代します。

**起動イベントトークを1回だけ話す [#a47071ee]
正月やバレンタインなど様々な行事に対応した起動イベントがありますが、そういうトークは1回で十分!って人向け。~
トークのあとにフラグ用変数に年月日を記録し、次に起動したときの年月日と比較して一緒だったらそのイベントトークにはジャンプしない。~
2回目以降は通常起動、又は通常交代します。

 *OnBoot
 >(現在月)月(現在日)日【タブ】(現在年)(現在月)(現在日)!=(イベント年月日)
 >起動
 
 *OnGhostChanged
 >(現在月)月(現在日)日【タブ】(現在年)(現在月)(現在日)!=(イベント年月日)
 >他のゴーストから変更
 
 *起動
 :こんにちは。
 
 *他のゴーストから変更
 :おつかれさまでした。
 :あとは任せな。
 
 *4月1日
 $イベント年月日【タブ】(現在年)(現在月)(現在日)
 :うそつきました。

来年になってもちゃんと起動イベントトークします。
年も記録しているので、来年になったらちゃんとイベントトークにジャンプします。



*独自起動終了イベント [#q1cb1e29]
起動/終了方法のうち、里々独自の起動/終了イベントです。~
里々独自内部イベントで、 

-OnSatoriBoot
-OnSatoriLoad
-OnSatoriUnload
-OnSatoriClose~
の4つがあります。~
~
参考:[[独自イベント]]

**OnSatoriBoot [#y08c3be8]
栞としての起動処理(セーブデータ読み込みetc)が終わった直後、里々自身が呼びます。~
OnBoot/OnGhostChangedより先、起動時には必ず呼ばれますので、OnBoot/OnGhostChangedで同じ初期化が必要な場合、そちらで行わずにOnSatoriBootで行えば一箇所でできてしまうわけです。追加修正も一元管理できるので便利です。~
&color(#ff0000){※SSPでキャッシュが発生した場合など、必ずしも呼ばれるとは限りません。一元管理する場合は下記の[[起動・終了・呼出・交代時に発生するイベントまとめ(SSP調べ)>#p5dedd7c]]を参照し、漏れがないように充分注意して下さい。};~

OnSatoriBoot中でトークが書かれた場合、里々はいったんそれを保存しておいて、OnBoot/OnGhostChangedが呼ばれた時、OnBoot/OnGhostChangedを呼ばずに、保存しておいたトークを優先します。

以下の例では、好感度を0にセットし、OnBoot/OnGhostChangedを無視して「こんにちは。」をトークします。

 *OnSatoriBoot
 $好感度=0
 :こんにちは。

easyballoonのorusubanなどでは、こちらを使うと便利です。

 *OnSatoriBoot
 (bln,change,ただいま起動中です。)

**OnSatoriLoad [#of52bbfd]
ロード直後に呼ばれます。~
OnSatoriBootとの違いは、ここで何かを返しても一切使用されないという事です。~
ここでトークを入力しても、OnBoot/OnGhostChangedのトークは潰されません。~
(追記)起動時以外に呼ばれることもあります。~

**OnSatoriClose [#df623d07]
OnSatoriBootと対になるイベントです。~
OnSatoriClose中でトークが書かれた場合、里々はいったんそれを保存しておいて、OnClose/OnGhostChangingが呼ばれた時、OnClose/OnGhostChangingを呼ばずに、保存しておいたトークを優先します。
  
**OnSatoriUnload [#t89bd9ab]
栞としての最終処理の直前、里々自身がコールします。
ここでトークを返しても使われることはありません。

*起動・終了・呼出・交代時に発生するイベントまとめ(SSP調べ) [#p5dedd7c]
各イベント詳細はリファレンスサイトや当ページ参考にして下さい。~
SSPには起動中にゴーストキャッシュという機能が働いており、SSPを終了するまで個別のゴーストの一時データを破棄せずに保管しています。~
このゴーストキャッシュが使われた時は通常起動時とイベント発生パターンが異なるので、フェーズ1のイベントを使用する場合注意が必要です。(特に前回終了状況に対して対応トークを正確に行おうとする場合や、終了時間を扱うような場合)

**簡易チャート [#rf281824]

-起動時
|CENTER:|CENTER:|CENTER:|CENTER:|c
|>|>|>|BGCOLOR(#fea):''起動指示''&br();↓|
|>|(キャッシュ有)|>|(キャッシュ無)|
|>|BGCOLOR(#fff):''OnCacheRestore''|>|BGCOLOR(#fff):''OnSatoriLoad''|
|~|~|>|↓|
|~|~|>|BGCOLOR(#fff):''OnSatoriBoot''|
|~|~|>|↓|
|~|~|>|BGCOLOR(#fff):''OnInitialize''|
|>|>|>|↓|
|(通常起動)|(初回起動)|(呼出)|(交替)|
|BGCOLOR(#fff):''OnBoot''|BGCOLOR(#fff):''OnFirstBoot''&color(#ff0000){※1};|BGCOLOR(#fff):''OnGhostCalled''&color(#ff0000){※1};|BGCOLOR(#fff):''OnGhostChanged''&color(#ff0000){※1};|

&color(#ff0000){※1};記述がない場合はOnBootが呼ばれる~

-終了時
|CENTER:|CENTER:|CENTER:|CENTER:|c
|>|>|>|BGCOLOR(#fea):''終了指示''&br();↓|
|(\-を実行して終了)|(SSPも同時に終了)|(ゴーストのみ終了)|(ゴースト交替)|
|BGCOLOR(#fff):''OnCacheSuspend''&color(#ff0000){※2};|BGCOLOR(#fff):''OnCloseAll''|BGCOLOR(#fff):''OnSatoriClose''|BGCOLOR(#fff):''OnSatoriClose''|
|~|↓|↓|↓|
|~|BGCOLOR(#fff):''OnSatoriClose''|BGCOLOR(#fff):''OnClose''|BGCOLOR(#fff):''OnGhostChanging''|
|~|↓|↓|↓|
|~|BGCOLOR(#fff):''OnClose''|BGCOLOR(#fff):''OnCacheSuspend''&color(#ff0000){※2};|BGCOLOR(#fff):''OnCacheSuspend''&color(#ff0000){※2};&color(#ff0000){※3};|
|>|>|>|↓|
|>|(SSPも同時に終了)|>|(ゴーストのみ終了/交替)|
|>|BGCOLOR(#fff):''OnDestroy''|>|BGCOLOR(#fff):なし|
|>|↓|~|~|
|>|BGCOLOR(#fff):''OnSatoriUnload''|~|~|

&color(#ff0000){※2};ゴーストキャッシュが有効な場合のみ~
&color(#ff0000){※3};自分自身に交替した場合は発生しない~

**ゴースト起動時(交替、呼出含む) [#xbbb02d3]

-フェーズ1 ~
--ゴーストキャッシュ無し~
 ''OnSatoriLoad'' → ''OnSatoriBoot'' → ''OnInitialize'' → フェーズ2へ~
~
--ゴーストキャッシュ有り(本体と同時にゴースト起動時は発生しない)~
 ''OnCacheRestore'' → フェーズ2へ~

-フェーズ2(ゴースト起動ケース別)~
初回起動、呼出、交替は各イベントトークが記載されない場合OnBootが呼ばれる。~
初回起動時はそれが交替であれ呼出であれOnGhostCalled/OnGhostChangedは発生しない。~

--通常起動~
 フェーズ1から → ''OnBoot''
--初回起動~
 フェーズ1から → ''OnFirstBoot'' または ''OnBoot''(OnFirstBootが記述されて無い場合)
--呼出~
 フェーズ1から → ''OnGhostCalled'' または ''OnBoot''(OnGhostCalledが記述されて無い場合)
--交替~
 フェーズ1から → ''OnGhostChanged'' または ''OnBoot''(OnGhostChangedが記述されて無い場合)

**ゴースト終了時(交替含む) [#jf942ef8]

-フェーズ1(ゴースト終了ケース別) 
--¥-を使用して終了~
 ''OnCacheSuspend''(ゴーストキャッシュ有効時のみ) → フェーズ2へ~

--終了(自ゴーストのみ起動中の場合)/全て終了~
 ''OnCloseAll'' → ''OnSatoriClose'' → ''OnClose'' → フェーズ2へ~
 ※¥![raise,OnClose]で終了した場合OnCloseAllは通らない

--終了(別ゴーストが起動中の場合)~
 ''OnSatoriClose'' → ''OnClose'' → ''OnCacheSuspend''(ゴーストキャッシュ有効時のみ) → フェーズ2へ~

--交替~
 ''OnSatoriClose'' → ''OnGhostChanging'' → ''OnCacheSuspend''(ゴーストキャッシュ有効時のみ) → フェーズ2へ~
 ※自分自身に交替する場合OnCacheSuspendは行われない

-フェーズ2~
フェーズ2が発生するのは下記の状況が発生した時でフェーズ1から時間的に連続して発生しない場合があります。~
ゴーストキャッシュ開放が行われるタイミングはSSP設定・使用状況により異なります、ゴーストキャッシュ無効・ゴースト数・保持時間が設定できます。~

--SSP終了/ゴーストキャッシュ開放/ゴーストキャッシュ無効でゴースト単体終了~
 ''OnDestroy'' → ''OnSatoriUnload''~
 ※データセーブでファイル書込みが行われるのは手動や自動セーブが指定されない限りこのケースのOnSatoriUnload後のみ

--SSP終了しないでゴースト呼出/交替が再度行われた場合~
 上記ゴースト起動時(交替、呼出含む)のフェーズ1へ~
 ※セーブデータはファイル書込みされていないがキャッシュから読み込まれる

**ゴーストを呼出(参考) [#p50df9b6]
 ''OnGhostCalling'' → ''OnGhostCallComplete''

トップ   編集 差分 履歴 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS