
self-hosted runner Ć Unityć§ć¢ć»ććć¬ćć„ć¼ćčŖååćć話 Now in REALITY Tech #137
ććć«ć”ćÆćUnityćØć³ćøćć¢ć®IKEPć§ćć
ęčæćÆć¢ććŖć®UnityéØåć®éēŗć ćć§ćŖććććććTA(Technical Art)é åć®éēŗćč”ćŖć£ć¦ććä»ę„ćć®é ć§ćć
åćÆå®åøøēćŖTAę„åćØćć¦ć¢ććæć¼ć¢ć»ććć®éēØć«ęŗćć£ć¦ćć¾ććććć®éēØćć©ćÆć«ććććć«ćć¢ć»ććć®ć¬ćć„ć¼ćčŖååććć®ć§ć瓹ä»ććććØęćć¾ćć
ć¢ććæć¼ć¢ć»ććć¬ćć„ć¼ć§ćØć³ćøćć¢ćććććØ
REALITYć§ćÆćArtćć¼ć ćć¢ć»ććć®å¶ä½/äæ®ę£ćč”ććArt / PdMć«ććå®ę©ē¢ŗčŖå¾ć«ććØć³ćøćć¢ć«åƾćć¦GitHub PRćåŗććØććéēØććć¦ćć¾ćć
ćØć³ćøćć¢ć«ć¢ć»ććPRć®ć¬ćć„ć¼ä¾é ¼ćę„ćꮵéć§ćUnityćøć®ć¢ć»ććēµćæč¾¼ćæćå®äŗćć¦ćććć¢ć¤ćć ć®č¦ćē®ć«é¢ćć¦ćÆćŖćŖć¼ć¹OKćŖē¶ę
ć«ćŖćć¾ćć
ćć®ćććØć³ćøćć¢ćÆććREALITYć¢ććŖć®ä»ę§ć«ę²æć£ć¦å¶ä½ććć¦ćććććØćć1ē¹ć®ćæć確čŖćć¾ćć
ć«ćé¢ććććć¢ććæć¼ć¢ć»ććć®ć¬ćć„ć¼ćÆéåøøć«å¤§å¤ćŖä½ę„ćØćŖć£ć¦ćć¾ććā¦
ć¢ć»ććć¬ćć„ć¼ć大å¤ćŖēē±
1. ć¢ććæć¼ć¢ć»ććć®ä»ę§ćč¤é
ć¢ććæć¼ćÆćć¼ć¼ććē»é¢ćč¦ć¦åććććć«ćREALITYć®ć¢ććæć¼ć¢ć¤ćć ć«ćÆę§ć
ćŖć«ćć“ćŖććććććććć§ć¢ć»ććå¶ä½ę¹ę³ćÆå¤§ććē°ćŖćć¾ćć
ć¾ććåćć«ćć“ćŖć§ćć¢ć¤ćć 蔨ē¾ć®éććŖć©ć«ćć£ć¦ćåæ
č¦/äøč¦ć«ćŖćć¢ć»ććę§ęćå¤ćć£ć¦ćććććē“40~50種ć®ä»ę§ćååØćć¦ćć¾ćć
(社å”ć§ćå
Øć¦ć®ć¢ć¤ćć 種å„ćåęććććØćÆé£ććć§ćććā¦)

2. PRć®é »åŗ¦ćØå¤ę“ćć”ć¤ć«ę°ćčØå¤§ć§ćć
ć¬ćć£ć¢ć»ććć®čæ½å ć ćć§ććē“30ć¢ć¤ćć ć500ćć”ć¤ć«ć«åć¶PRć«ćŖććęć«2~4ę¬ć®ć¬ćć£ććŖćŖć¼ć¹ććć¦ććć®ć§ććć®åŗ¦ć«ć¬ćć„ć¼ćēŗēćć¾ćć
ć¾ććäøå
·åćč¦ć¤ććć°ćććć®ć¢ć»ććć®äæ®ę£ć«åƾććć¬ćć„ć¼ćč”ćć¾ćć
3. GitHubäøć§ć®ē¢ŗčŖćå°é£
ć¢ć»ććć®PRćÆéåøøć®ć³ć¼ćć¬ćć„ć¼ćØéććFBXćPrefabćććÆć¹ćć£ćŖć©ć®ćć¤ććŖćć¼ćæć§ę§ęććć¦ćććććåć
ć®ćć¼ćæć®ē¢ŗčŖćććććć®åē
§é¢äæć®čæ½č·”ćŖć©ćGitHubäøć§ē¢ŗčŖććććØćå°é£ć§ćć
ć¾ćć¢ć¤ćć ć®ēØ®å„ć«ćć£ć¦ćÆććē¹å®ć®ćć”ć¤ć«ćć¹ć«é
ē½®ćć¦ćććØć¢ććŖććå©ēØććććć®ććććć®ć§ćę£ćććć£ć¬ćÆććŖ/ćć”ć¤ć«åć«ćŖć£ć¦ććŖćå “åćÆćć¢ććŖććčŖćæč¾¼ćæćććäøč¦ćć”ć¤ć«ćØćŖćåÆč½ę§ćććć¾ćććććć®ćć£ć¬ćÆććŖ/ćć”ć¤ć«åćäøåäøå„ééć£ć¦ćŖćććäŗŗåć§ē¢ŗčŖććć®ćé£ććć§ćććć
ććć§ććććć®åé”ćč§£ę¶ććććć«ćććØć³ćøćć¢ćč”ć£ć¦ćććć§ććÆä½ę„ćčŖååćć¾ććļ¼
Unity Editorę”å¼µć§ćć§ććÆå¦ēćå®č£
ę ¹ę¬ćØćŖććć§ććÆå
容ć«ć¤ćć¦ćÆUnity Editorę”å¼µć§å®č£
ćć¾ććć
ćć«ćć¦ć³ććå¶ä½ććć¢ććæć¼ć¢ć¤ćć ćéøęćććØćé¢é£ććć¢ć»ćććć¼ćæććć§ććÆćććć§ććÆēµęććē·č²: ę£åøøćććé»č²: åæ
č¦ć«åæćć¦äæ®ę£ććć赤č²: åæ
é ć®äæ®ę£ę示ćć§č”Øē¤ŗććć¾ćć

ä¾ćć°ćććććŖć¢ć«ć®ē¹å®ććććć£ć«ćē¹å®ć®ććÆć¹ćć£ćē»é²ććć¦ććććććć§ććÆććå¦ēćÆćAssetDatabasećŖć©ć使ćć°ć仄äøć®ććć«ē°”åć«å®č£ ć§ćć¾ćć
/// <summary>
/// ćććŖć¢ć«ć®ē¹å®ć®ććććć£ć«ē¹å®ć®ććÆć¹ćć£ćčØå®ććć¦ćććććć§ććÆćć
/// </summary>
/// <param name="materialCheck">ćć§ććÆēµęć®ę ¼ē“å
</param>
/// <param name="shaderProperty">ććÆć¹ćć£ććććŖć¢ć«ć®ć©ć®ććććć£ć«čØå®ććć¦ććć¹ćć</param>
/// <param name="isEssential">åæ
é é
ē®ć</param>
/// <param name="expectedTexturePath">`shaderProperty`ć«ē»é²ćććć¹ćććÆć¹ćć£ć®ćć”ć¤ć«ćć¹</param>
public bool CheckTextureAssignedToMaterial(ref CheckResult materialCheck, int shaderProperty, bool isEssential, string expectedTexturePath)
{
// ćććŖć¢ć«ćØē»é²ććć¦ććććÆć¹ćć£ćåå¾
var material = AssetDatabase.LoadAssetAtPath<Material>(materialCheck.FullPath);
var texture = material.GetTexture(shaderProperty);
// ęå¾
ććÆć¹ćć£ććććŖć¢ć«ć«ē»é²ććć¦ćććććć§ććÆćć
// ćęå¾
ććÆć¹ćć£ćććććååØććŖćććććććŖć¢ć«ć«ä½ć®ććÆć¹ćć£ćē»é²ććć¦ććŖććććęå¾
ććÆć¹ćć£ćÆååØććććććŖć¢ć«ć«ē»é²ććć¦ććŖćććå¼¾ć
var isExpectedTexture = File.Exists(expectedTexturePath) && texture != null;
if (isExpectedTexture)
{
var path = AssetDatabase.GetAssetPath(texture);
// ćå
Øćé¢äæćŖćććÆć¹ćć£ććććŖć¢ć«ć«ē»é²ććć¦ćććć®ćå¼¾ć
isExpectedTexture &= path == expectedTexturePath;
}
// ćć§ććÆēµęć®ć¹ćć¼ćæć¹ćØč”Øē¤ŗēØć®ć”ćć»ć¼ćøćę ¼ē“
materialCheck.Details.Add(new CheckDetail
{
Status = isExpectedTexture ? CheckStatus.Ok : isEssential ? CheckStatus.Error : CheckStatus.Warning,
Message = isExpectedTexture
? $"{expectedTexturePath}ććććŖć¢ć«ć«ē»é²ććć¦ćć¾ć"
: $"{expectedTexturePath}ććććŖć¢ć«ć«ē»é²ććć¦ćć¾ćć",
});
return isExpectedTexture;
}ćććć£ćē“°ć ćØćććć§ććÆå¦ēćå¤ćå®č£ ćć¤ć¤ććć¢ć¤ćć ććØć®ä»ę§ćę“ēćé©åć«ä½ē³»åććććØć§ćREALITYć®ć¢ććæć¼ć¢ć¤ćć ä»ę§ć®ć»ć¼å Øć¦ć«åƾćć¦čŖåćć§ććÆåÆč½ćŖćć¼ć«ćå®ē¾ćć¾ććļ¼ļ¼
å ·ä½ēćŖćć§ććÆé ē®ć«ć¤ćć¦ćÆč¤éćŖććå²ęćć¾ććć1ć¢ć¤ćć ä»ę§ć§ćē“20~50ć®ćć§ććÆé ē®ććććåé ē®ć®å®č£ ēē±ć
㻠対åæććć¦ććŖććØć¢ććŖäøć§ćØć©ć¼ćēŗēćć
㻠対åæććć¦ććŖććØč¦ćē®ćē “ē¶»ććåÆč½ę§ććć
ć» ć¢ć»ććéēØć«ććć¦ē®”ēćåę»ć«č”ććććć«ćććć
ćŖć©ćę§ć ć§ćā¦
ć¾ććUnity Editorę”å¼µć§å®č£
ćććććć¢ć»ććēµćæč¾¼ćæå¾ć«Artćć¼ć čŖčŗ«ć§ć¢ć»ććēµćæč¾¼ćæå
容ćę£ćććć確čŖć§ććć®ć大ććŖē¹ćØćŖć£ć¦ćć¾ćļ¼
åé”ćććå “åćå³ęäæ®ę£ćććććØćåÆč½ć§ćććććć¢ć»ććå¶ä½ć®å¹ēåć«ććŖć£ćććØęć£ć¦ćć¾ćć
self-hosted runnerć§ć¢ć»ććPRć®ć¬ćć„ć¼ćććć
åé ć§čæ°ć¹ćććć«ćREALITYć§ćÆć¢ć»ććć®ćŖćŖć¼ć¹åć«GitHub PRć«ćć£ć¦ćØć³ćøćć¢ćøć®ć¢ć»ććć¬ćć„ć¼ä¾é ¼ćč”ććć¦ćć¾ćć
PRć«å«ć¾ćććć”ć¤ć«ćÆćę°ćčØå¤§ć§ćć£ććććć¤ććŖćć¼ćæć§GitHubäøć§ē¢ŗčŖć§ććŖćć£ćććć¾ćć
ććć§ćGitHub Actions self-hosted runnerććUnity Editorę”å¼µćØćć¦å®č£
ćććć¼ć«ćčµ·åćććć§ććÆēµęćPRć«ć³ć”ć³ććććććć«ćć¾ććļ¼

Unity Editorę”å¼µć§ć®č”Øē¤ŗå
容ćØåććć§ććÆēµęćć¢ć¤ćć ććØ/ćć”ć¤ć«ććØć«č”Øē¤ŗććć¾ćć
ć¾ććPRć®ćć”ć¤ć«å·®åćå
ć«ćć§ććÆåÆ¾č±”ć¢ć¤ćć ćē®åŗćć¦ćććććčŖåćć§ććÆåÆ¾č±”å¤ć®ćć”ć¤ć«äøč¦§ćę¤åŗććć¾ććäøč¦ćć”ć¤ć«ćę··ćć£ć¦ććå “åćÆćć”ć¤ć«åé¤ć®äæ®ę£ę示ćč”ć£ććććć§ććÆćć¼ć«ć対åæćć¦ććŖćåæ
č¦ćŖćć”ć¤ć«ć§ććć°ćććć ććäŗŗåć§ē¢ŗčŖććć ćć§čÆćä½å¶ć«ćŖć£ć¦ćć¾ćć
self-hosted runnerććUnity Editorćčµ·åććę¹ę³ć«ć¤ćć¦ćÆćāć®čØäŗć§ē“¹ä»ćć¦ććå 容ćØć»ć¼åę§ć§ćć
name: ć¢ććæć¼ć¢ć»ććć®PRćć§ććÆ
on:
pull_request:
types: [labeled]
jobs:
validation:
name: ć¢ććæć¼ć¢ć»ććć®ććŖćć¼ć·ć§ć³
runs-on: [self-hosted]
if: |
(github.event.action == 'labeled') &&
(github.event.label.name == 'avatar_asset_validation')
env:
RESULT_TEXT_FILE_NAME: avatar_asset_validation_result
RESULT_TEXT_FILE_EXTENSION: txt
steps:
- uses: DeNA/setup-job-workspace-action@v3
with:
workspace-name: "avatar-asset-validation"
- uses: actions/checkout@v4
with:
fetch-depth: 0
clean: false
lfs: true
- name: CleanLocalFiles
run: |
git reset --hard
git clean -df
- name: AvatarAssetValidation
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
# PRć®ćć”ć¤ć«å·®åäøč¦§ćåå¾ććUnity Editorććććć¢ć¼ćć§čµ·å
PR_DIFF_FILES=`git diff origin/${GITHUB_BASE_REF}...origin/${GITHUB_HEAD_REF} --name-only`
make avatar-asset-validation RESULT_TEXT_FILE_NAME="${RESULT_TEXT_FILE_NAME}.${RESULT_TEXT_FILE_EXTENSION}" PR_DIFF_FILES="$PR_DIFF_FILES"
- name: ReportResult
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
PR_NUM: ${{ github.event.pull_request.number }}
run: |
# Unityć§ä½ęććć³ć”ć³ćå
容ćPRć«čØč¼ćć
files="Wasabi/${RESULT_TEXT_FILE_NAME}_*.${RESULT_TEXT_FILE_EXTENSION}"
for filepath in $files; do
COMMENT_TEXT=`cat ${filepath}`
gh pr comment $PR_NUM --body "$COMMENT_TEXT"
doneć¾ććUnityå“ć§ćÆä»„äøć®ćććŖå®č£
ćēØęćć¦ćććććØć§ććć”ć¤ć«ćć¹äøč¦§ćććć§ććÆåÆ¾č±”ćØćŖćć¢ć¤ćć ć®ē¹å®ćććć§ććÆēµęć®ććć¹ćę“å½¢ćŖć©ćÆććć¤ć¤ććUnity Editorę”å¼µć§å®č£
ćć¦ćććć§ććÆććøććÆććć®ć¾ć¾ę“»ēØććććØćć§ćć¾ćć
ćć¤ć³ććØćć¦ćÆćUnity Editorććććć¢ć¼ćć§čµ·åććéć«éåęć”ć½ćććå®č”ććå “åć -quitćŖćć·ć§ć³ćęå®ćć¦ćć¾ććØéåęå¦ēć®å®äŗćå¾
ććć«Unity Editorćēµäŗćć¦ćć¾ććććC#ć®å®č£
å“ć§Unity EditorćēµäŗććććććŖåéæēćåæ
č¦ćØćŖćć¾ćć
/// <summary>
/// GitHub Actionsććå®č”ććć
/// Git PRć§å·®åę¤åŗććććć”ć¤ć«ćć¹äøč¦§ćå¼ę°ć§åćåććå·®åćć”ć¤ć«ćååØććć¢ććæć¼ć¢ć»ććć®ćć§ććÆćå®č”
/// å¦ēć®éäøć§éåęå¦ēć®å®äŗćå¾
ć¤ććć«ćCLIććć®ćććć¢ć¼ćå®č”ć§ćÆ`-quit`ćć¤ććć«å®č”ććć
/// (ę¬ć”ć½ććć®ęå¾ć®å¦ēć§EditorApplication.Exit(0)ćå¼ć³åŗććććUnityčŖä½ćÆę£åøøć«ēµäŗććć)
/// </summary>
public static void CheckAvatarAssetsFromGitHubActions()
{
CheckAvatarAssetsFromGitHubActionsInternalAsync(CancellationToken.None).Forget();
}
private static async UniTask CheckAvatarAssetsFromGitHubActionsInternalAsync(CancellationToken cancellationToken)
{
var args = Environment.GetCommandLineArgs();
var validationResultTextFileName = "avatar_asset_validation_result.txt";
string[] diffFilePaths = { };
for (var i = 0; i < args.Length; i++)
{
switch (args[i])
{
// ćć§ććÆēµęć®åŗåćć”ć¤ć«åćåå¾
case CliResultTextArgFlag:
validationResultTextFileName = args[i + 1];
break;
// å·®åćć”ć¤ć«ć®ćć¹äøč¦§ćåå¾
case CliDiffFilesArgFlag:
diffFilePaths = args[i + 1].Split("\n");
break;
}
}
try
{
// GitHubććććć£ćå·®åćć”ć¤ć«äøč¦§ćå
ć«ććć§ććÆåÆ¾č±”ć®ć¢ććæć¼ć¢ć¤ćć ć®äøč¦§ćē¹å®
var avatarItemList = await ExtractAvatarItemsAsync(diffFilePaths, cancellationToken);
// ć¢ććæć¼ć¢ć¤ćć ććØć«ćć§ććÆå¦ēćå®č”
// Unity Editorę”å¼µć§å©ēØćć¦ććććøććÆćØåććć®ćę“»ēØ
var checkResultList = await CheckAvatarAssetsAsync(avatarItemList);
// åć¢ć¤ćć ć®ćć§ććÆēµęććGitHub PRć«ć³ć”ć³ćććēØć®ććć¹ććēę
var resultText = GenerateReportText(checkResultList, diffFilePaths);
// GitHub PRć«ć³ć”ć³ćććēØć®ććć¹ćććć”ć¤ć«ć«åŗå
await File.WriteAllTextAsync(validationResultTextFileName, resultText, cancellationToken);
}
catch (Exception e)
{
await File.WriteAllTextAsync(validationResultTextFileName, "ćØć©ć¼ćēŗēććć®ć§ćę£åøøć«ćć§ććÆćč”ćć¾ććć§ćć", cancellationToken);
}
// Unityććććć¢ć¼ćć§čµ·åććęć«`-quit`ćć¤ććć«å®č”ćć¦ććć®ć§ćå
Øć¦å¦ēćå®äŗćććUnityćēµäŗćć
EditorApplication.Exit(0);
}ćććć«
ć¢ć»ććć¬ćć„ć¼ćčŖååććēµęććØć³ćøćć¢ć®ć¬ćć„ć¼ć³ć¹ććć»ć¼0ć«ććććØćć§ćć¾ććļ¼ä»„åćÆ4, 5ęéććććććŖć¬ćć„ć¼ćč”ć£ć¦ćć¾ććććä»ć§ćÆę°åć§ć¬ćć„ć¼ćå®äŗć§ćććććéēŗä½ę„ćŖć©å„ć®ćæć¹ćÆć«ćŖć½ć¼ć¹ćå²ććććć«ćŖćć¾ććļ¼
čæå¹“ććčØć£ćä½ę„ćå®č£
ćÆAIć«ćć£ć¦ćććććØćå¢ćć¦ćć¾ććććć¾ć ć¾ć äŗŗéćč² ććŖćććØććę°ęć”ć«ććŖćć¾ćć
ä»å¾ćććčØć£ćå¹ēåćŖć©ćÆć©ćć©ććć£ć¦ććććć§ćļ¼
REALITYć§ćÆUnityćØć³ćøćć¢ćåéćć¦ćć¾ććć¢ććŖéēŗć ćć§ćŖććććčØć£ćéēØćę¹åę“»åćŖć©ćē©ę„µēć«č”ć£ć¦ćć¾ćć
REALITYć®Unityéēŗć«ćčå³ććęć”ć®ę¹ćÆć仄äøć®ćŖć³ćÆćććć²ćåæåćć ććć