はじめに

Teams版のPower Virtual AgetnsとPower Automateを利用して、作成した神経衰弱ゲームの解説その２になります。
「その１（初期処理）はこちら」
「その２（ループトピック）はこちら」

Power Platform 2022 release wave1 で Power Automate と Power Virtual Agetns がより便利で面白くなりそうで嬉しい！
嬉しさ余って、娘にも遊んで欲しくて神経衰弱を可愛くしてみました。#PowerApps #PowerAutomate #PowerVirtualAgents pic.twitter.com/a80RnwfaCa
— Miyake Mito (@MiTo60448639) January 26, 2022

フロー「神経衰弱処理」

今回は神経衰弱のメイン処理となる、神経衰弱処理フローについて説明します。

全体図

このフローは、神経衰弱の1ターンである1手目と2手目のそれぞれで、共通で呼び出されるフローとなります。
よって、2手目の処理では、最後にめくったカードが1手目と同じか判断を行います。

１．フローのパラメータ

① めくったカードの値。1手目と2手目で異なります。

② 初期処理にて生成されたランダムな数字配列

③ 場のカード。1手目と2手目で異なります。

④ 1手目でめくったカードの値。1手目処理のときは"null"を設定します。その後、当フローでアウトプットされた値を、2手目でインプットとします。

⑤ 1手目をめくる前の場のカード。当フローを呼び出すトピックA、およびトピックBのインプットである場のカードの値です。ハズレだった場合にめくったカードを戻すためにインプットとします。

２．場のカードの機種依存文字を通常文字に変換

チャットボットでの見栄えをよくするために、チャットボットでの表示には機種依存文字を多用します。
機種依存文字は、Power Automate にて substring() で文字長が2となる場合があります。（サロゲートペアは2と予想しています）
以後の文字位置の算出処理等を複雑化しないために、フローの先頭で文字長が1の文字に置換し、フローの後半で戻します。
当初はトランプをイメージして作成していたため、1~13 の文字をＡ,②~⑩,Ｊ,Ｑ,Ｋの文字に置き換えています。

変換前
🔳🐭🐞🐯🐔🐻🐼🐟🐨🐶🐷🐸🐹🐛

変換後
■ Ａ ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ ＪＱＫ

最後に、1行目（列番号を表示）もまるっと置換します。

replace(outputs('特殊文字を変換_14'), '🔲 ❶ ❷ ❸ ❹ ❺ ❻ ❼ ❽ ❾', '▯１２３４５６７８９')

３．ランダムな数字配列を、数字のarrayに変換

次にランダムな数字配列を、カンマ区切りの横並びの状態からJSON配列に変換します。

split() で一発です。

４．場のカードにおける、Inputの「めくったカード」の位置を特定

場のカードは文字列として扱います。

今回めくったカードは、行⇒列の番号で指定します。
(下図の黄色いセルは「3の6」）

指定された行列に対する、場のカードの位置を取得します。
(下図の黄色いセルは「43」）

めくったカードの列を X とします

めくったカードの行を Y とします

行番号や改行を加味し、場のカードにおけるめくったカードの位置を求めます。

　　X+1+Y×12

で取得可能です。

５．ランダムな数字配列における、「めくったカード」に該当する数字を特定

ランダムな数字配列は、上記でJSON配列に変換しました。そのJSON配列の添え字と、めくったカードの関係は下図になります。
（めくったカードが「36」ならば、JSON配列の添え字は「24」）

上記のJSON配列の添え字は、

　　X+(Y-1)×9-1

で求められます。

この添え字を、JSON配列化したランダムな数字配列に指定すると、ランダムな数字配列における数字が取得できます。

ランダムな数字は1~54で構成されています。
13で除算した剰余が、トランプのA~Kに相当します。

剰余は10~12の2桁数字も含むため、そのまま場のカードに挿入してしまうと桁ズレが起きます。
一桁の数字
　　■■■■■　⇒　■■■8■
は問題ありませんが、二桁の数字
　　■■■■■　⇒　■■■12■
は桁ズレが発生します。

よって、ここでもＡ,②~⑩,Ｊ,Ｑ,Ｋへの置換を行います。

文字の置換は、スイッチアクションで可能ですが、フローが横に広がり見難くなるため、

Hiroさんの「横長なSwitchアクション・条件分岐はJSON Dictionaryですっきり短く」を利用するとすっきりします。すごいテクニックです。

マッピング表をJSONで作成し、
（これもExcelとテキストエディタを駆使すれば簡単に作成可能です）

上記マッピングのキーに、取得したランダムな数字配列における数字が一致したら値を返す if() を記載します。
（今回は一致しないことはあり得ないので、if() のtrue条件は null とかでも問題ありません）

６．場のカードにめくったカードを情報を付与

「２．場のカードの機種依存文字を通常文字に変換」の結果に対し、1文字ずつのJSON配列を作成します。
その際、indexとして文字位置を付与していきます。

[データ操作]－[選択]アクションで、開始には、２．場のカードの機種依存文字を通常文字に変換の結果をセット。

マップには、

index ： item()
value ： substring(outputs('Card'), item(), 1)

上記[選択]の出力に対し、上記の「４．場のカードにおける、Inputの「めくったカード」の位置を特定」で取得した位置に、「５．ランダムな数字配列における、「めくったカード」に該当する数字を特定」で変換したカードを差し込みます。

再度、[選択]を追加します。

マップには以下を設定してください。

if(equals(outputs('Firsthandint_onCard'), item()?['index']), variables('turnCard'), item()?['value'])

最後に、JSON配列を文字列に変換します。
[データ操作]－[結合]アクションを利用し、結合文字はnullです。

７．場のカードの通常文字を機種依存文字に変換

「２．場のカードの機種依存文字を通常文字に変換」で変換した通常文字を機種依存文字に戻します。

変換前
■ Ａ ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ ＪＱＫ

変換後
🔳🐭🐞🐯🐔🐻🐼🐟🐨🐶🐷🐸🐹🐛

８．めくったカードが2枚目の場合、当たり/ハズレの判定をする

上記の「１．フローのパラメータ」の1手目でめくったカードの値がnullでない場合、2枚目をめくったとき独自の処理を行います。

2枚目の場合は、1枚目でめくったカードと一致するか判定します。
「１．フローのパラメータ」の1手目でめくったカードの値と、「５．ランダムな数字配列における、「めくったカード」に該当する数字を特定」の値を比較します。

一致する場合は当たりの画像と、「７．場のカードの通常文字を機種依存文字に変換」で作成した場のカード情報をフローのアウトプットに設定します。
一致しない場合はハズレの画像と、「１．フローのパラメータ」の1枚目をめくる前の場のカードをアウトプットに設定します。

当たりとハズレの画像は、いらすとやさんから頂きました。

チャットボットの応答に画像を表示する方法は、
「Power Virtual Agents でチャットボットに画像を表示する【改定版】」
を参照ください。

また、当たりはずれを加味した場のカードとして
・当たりの場合は「６．場のカードにめくったカードを情報を付与」にかかわらずめくった後の場のカード
・ハズレの場合は1枚目と2枚目のカードを元に戻すため「１．フローのパラメータ」で受け取った1手目をめくる前の場のカード
を設定します。

９．フローのアウトプット

① 「７．場のカードの通常文字を機種依存文字に変換」で変換した場のカード（当たり/ハズレ結果は反映していないもの）

② 「８．めくったカードが2枚目の場合、当たり/ハズレの判定をする」の当たり/ハズレの画像

③ 「８．めくったカードが2枚目の場合、当たり/ハズレの判定をする」の当たりはずれを加味した場のカード

⑤ 1手目をめくる前の場のカードは、当フローを呼び出すトピックA、およびトピックBのインプットである場のカードの値です。ハズレだった場合にめくったカードを戻す際に利用します。

まとめ

全3回でPower Virtual Agetns と Power Automate を利用した神経衰弱ゲームの説明をしました。
文字列の処理では繰り返し処理を多用するルーチンですが、Power Automate のApply to each を利用すると処理時間が激増し、
チャットボットでのゲームとしては成立しません。
よって、Apply to each を一切使わないロジックを構築しました。