ID Token 요청에 client_secret이 필요하기 때문에 (보안이슈)

서버를 한 번 경유하기 위한 RequestTokenFromServer 로 대체되어 사용하지 않게 된 스크립트

private async Task ExchangeCoroutine(string code) 
{
    try
    {
        await Awaitable.MainThreadAsync();
        Debug.Log("토큰 요청 시작");
        WWWForm form = new WWWForm();
        form.AddField("code", code);
        form.AddField("client_id", clientId);
        form.AddField("redirect_uri", redirectUri);
        form.AddField("grant_type", "authorization_code");
        UnityWebRequest req = UnityWebRequest.Post("https://oauth2.googleapis.com/token", form);
        Debug.Log("UnityWebRequest 생성 완료");
        await req.SendWebRequest();
        if (req.result != UnityWebRequest.Result.Success)
        {
            Debug.LogError($"Token 요청 실패: {req.error}");
            Debug.Log(req.downloadHandler.text);
            return;
        }
        string result = req.downloadHandler.text;
        JObject obj = JObject.Parse(result);
        string idToken = obj["id_token"]?.ToString();
        Debug.Log($"ID Token 얻음: {idToken}");
        await FirebaseLogin(idToken);
    }
    catch (Exception ex)
    {
        Debug.LogError($"토큰 교환 도중 예외 발생: {ex}");
    }
}

[기재사항]
1. 오류 확인 날짜/시간:
2025년 6월 25일, 2시 28분

2. 오류 발생 월드명/캐릭터명:
챌린저스4/렌뿅쭉

3. 오류 발생 콘텐츠명:
게임종료 UI에 필요한 내용이 누락된 것처럼 보임

4. 오류 내용:
챌린저스 패스에서 받기 가능한 상태의 완료된 미션의 수령 알림이 한 주의 마지막 날인데도 게임 종료 시 알림에 표시되지 않음

https://youtu.be/mYzqGqOi9OA

모바일이었으면 더 쉽게 구현할 수 있지만, PC의 경우는 Firebase SDK 에서 관련 기능을 지원하지 않음.

따라서 서버를 열고 구글 로그인을 한 뒤 인증 정보를 콜백받아 유니티에서 사용하는 방식을 채택함.

1. 새 창에서 열기는 크롬 팝업 관련 정책이슈로 불가능

2. 새 탭에서 연 뒤, 로그인 완료 후 닫는 것은 유니티에서 직접 연 창(Window)가 아니기에 제어가 불가능

마지막 레시피인 철학자의 소금을 완성하고, 처음부터 다시 레시피 개선에 착수

최적 경로를 찾아 재료를 줄이는 과정에서, 자연스레 중복 재료가 가능한 적게 들어가도록 구성

개선 전과 후 순으로 이미지 나열

1. 니그레도

2. 알베도

3. 시트리니타스

4. 루비도

어셈블 업데이트로 전직업 2차전직까지 스킵이 가능해져 궁성비를 바로 사용 가능하다.
제로 정도만 참고하면 될 듯 하다. (제로는 스킵 되는지 아직 확인을 안 해본 상태)

#. 유니온 멤버 등록 조건

유니온 멤버에 포함되려면 '2차 전직' 조건을 만족해야 한다.

#. 작성 현황

[작성] 모험가, 시그너스, 레지스탕스, 듀얼블레이드, 패스파인더, 아크, 일리움, 카인, 호영, 은월, 라라, 제로
[미작성] 아란, 에반, 메르세데스, 팬텀, 엔젤릭버스터, 키네시스, 카데나, 제논, 캐논슈터, 미하일, 카이저, 아델, 칼리

1-1. 모험가 계열

스토리 스킵이 가능하다면, 슈가를 클릭하여 스토리 스킵 → 1차전직 → 머리 위 전구로 스토리 스킵 후 2차 전직하여 완료
스토리 스킵이 불가능하다면, 메인 스토리를 따라가며 2차 전직까지 도달하도록 하자. (첨부할 자료 부족)

모험가 스토리의 스킵은 4차 전직을 한 모험가 직업이 있을 경우 가능하다.
즉 한 번은 스토리를 정직하게 밀거나 잘 알려진 편법을 사용한다.
대표적인 편법으로는, 패스파인더 101레벨 이상 달성 후, 자유전직 시스템(직업변경)을 통해 보우마스터나 신궁으로 전직하는 방법이 있다. 자유전직은 미나르 숲 : 산양의 골짜기1로 텔레포트 후 전직관이 모여있는 '사제의 숲'으로 이동, 전직관에게 말을 걸어 진행이 가능하다. 자유전직 시, 현재 레벨에 따라 메소를 지불해야 하며, 레벨이 높을수록 많은 비용을 지불한다.
만약 패스파인더로 궁성비를 사용해서 200레벨이 된 후 자유전직을 시도하면 4.6억메소를 지출해야 하므로, 101레벨까지 직접 육성한다는 선택지와 저울질이 필요하다.

1-2. 시그너스 직업
튜토리얼과 1차전직 완료 후, 나인하트의 [시그너스 기사단] 수련기사의 끝 퀘스트로 2차전직 진행
몬스터에게서 전리품 획득 후 에레브로 돌아가야 하는데, 거리가 좀 있으므로 텔레포트 또는 마을이동 기능을 사용하면 좋다.
퀘스트와 함께 2차전직도 함께 완료된다.

1-3. 레지스탕스 직업

마을에 도착 할 때까지의 스토리 진행을 해야한다.
궁성비를 통해 10레벨 이상이 되었다면, 좌측 전구 아이콘 에서 [레지스탕스] 의문의 초대장 퀘스트를 받아, 인벤토리에서 초대장 사용 후 1차 전직을 진행한다.
전구를 통해 [레지스탕스] 방과 후 특별수업 및 [레지스탕스] 복수와 성장 퀘스트를 진행하여 2차 전직 완료
적을 처치해야 할 에델슈타인 임시공항의 위치는 아래와 같다.

2. 듀얼 블레이드 / 듀블 (10분+)

슈가 클릭 후 스토리 스킵
→ 비화원 진입 후 튜토리얼 룸 세 단계 클리어
→  넬라, 제이엠, 돈 지오바네 조사
→ (1.5차 전직)탁한 유리구슬 깨뜨리기
→ 머리 위 전구 퀘스트를 통해 헤네시스 이동
→ 헤네시스에서 머리 위 전구를 통해 모험가 스토리 스킵
→ 좌측 전구 아이콘의  [모험가] 비화원으로 돌아가는 법 퀘스트 완료 및 획득한 스킬을 사용하여 전직관에게 이동
→ 전직관에게 말을 걸어 2차 전직 완료

2차 전직 퀘스트가 어째서인지 좌측 전구에 뜨지 않아서 직접 설희(전직관)을 찾아가야 한다.

3. 패스파인더 / 패파

동굴맵 탈출 후 바로 머리 위 전구를 통해 전직 가능

4. 아크

피난처 튜토리얼과 관계 없이 레벨만 되면 2차 전직이 가능하다.(한 번 더 검증 필요)

5. 일리움(30분)

2차전직을 위해 초반 스토리 진행 필요. 막힘 없이 진행 시, 약 30분 소요.
스토리 진행 중 지역 간 텔포 이동이 불가능하여 이동에 시간을 많이 소모한다.
또한, 아이템을 주워야 하는 퀘스트가 많아 펫이 있다면 조금 더 수월하게 진행이 가능하다.
아카데미아에서 각성(흰머리)과 함께 2차전직 완료.
유니온 UI를 띄울 수 없는 지역이지만 정상적으로 완료되었으므로 바로 종료하여도 무방함.

6. 카인

제일 먼저 보이는 스토리 퀘스트를 받고, 문 밖을 나가 NPC로부터 퀘스트를 진행하면 1차전직을 할 수 있고, 레벨이 될 경우 머리 위 전구를 통해 2차전직 바로 가능.
1층 서쪽 통로에서 머리 위에 뜬 전구를 통해 헬리시움으로 빠지지 않도록 주의. 실수로 헬리시움으로 이동되었다면, 다시 해당 맵으로 돌아와 스토리 퀘스트 진행하도록 하자.

7. 호영(5분)

스토리 퀘스트 조금 진행하여 도철을 봉인에서 풀어준 뒤, 1차 전직 후 바로 머리 위의 전구를 통해 2차 전직이 가능.
캐릭터 생성부터 약 5분 소요.
유니온 UI를 열 수 없는 지역이지만, 2차 전직만 완료되었다면 문제 없이 유니온 효과 적용.

8. 은월(15분)

여우마을 탈출과 함께 2차전직

9. 라라(3분?)

퀘스트 [라라] 내가 도와줄까? 및 [라라] 가까워진 산 꼬마들 로 1차 전직을 완료 후, 머리 위 전구 퀘스트 [헬리시움] 판테온으로 또는 길라잡이로 나린 밖으로 이동하고, 머리 위 전구를 통해 2차 전직

꼭 시작맵에서 1차 전직을 하고 이동하자.

실수로 1차 전직 전에 나린 밖으로 이동하였을 경우에는 아래 표시된 위치로 돌아가서 1차 전직을 완료한다.

10. 제로(약 5분?)

아래 필드에 도달 할 때 까지 튜토리얼 진행, 궁성비 사용 시 바로 유니온 멤버에 등록된다.

11. 루미너스

스토리 진행 중 엘리니아 사냥터 맵 진출 시점에서 전구 아이콘을 통해 2차 전직

99. 번외 - 캐릭터 슬롯 채우기 추천 직업 : 레지스탕스

생성하자마자 아무런 컷씬 없이 메뉴 조작이 가능하다

99. 번외 - 유니온 레벨 채우기 추천 직업 : 모험가, 라라

비교적 컷씬이 짧은 직업.
필자가 아직 플레이하지 않은 직업도 있어 최선이 아닐 수도 있음.

개인 프로젝트를 하며 작성한 내용을 깃허브에 '공개' 상태로 올리고 싶은데, 위와 같이 민감한 키가 함께 올라가면 개인 프로젝트든 팀 프로젝트든 무척 큰 문제가 된다. 나중에 알아채고 지운 뒤 커밋을 하여도 아무튼 로그에는 남기 때문에 꽤나 머리가 아픈 상황.

파이썬 등의 경우, '.env' 라는 이름의 파일을 두어 민감한 정보 등을 모아 읽어들여 사용하고, 해당 파일은 깃에 올리지 않는다.

그리고 배포 시에는 플랫폼에서 해당 환경변수들을 직접 사용자가 입력하여 사용하는 등의 지원이 잘 되어있다.

유니티에서는 스크립트를 읽을 수 있는 배포환경에서 민감한 내용을 따로 숨기는 방식은 찾지 못했기 때문에, '.env'와 같은 방식을 유니티에서도 사용하면 되겠다.

1. env 파일 생성 (예: Assets/.env)

WEB_SOCKET_URL=wss://ssyoutube.****
CHANNEL_ID=UCOU****
PAGE_IDX=mNzL****

1+. env 작성 가이드 파일 생성(예: Assets/.env_template)

다른 사용자가 작성하기 용이하도록 탬플릿을 작성 해 놓자.

".env"파일을 ignore 되기 전에 미리 커밋 해 두는 방식도 생각할 수 있지만, 프로젝트의 진행에 따라 필요한 내용이 많아질 수 있어 아래와 같은 방식이 좋을 듯 하다.

WEB_SOCKET_URL=
CHANNEL_ID=
PAGE_IDX=

2. .gitignore에 내용 추가.

/Assets/.env

3. Unity에서 .env 파일 파싱 클래스 작성

using System.Collections.Generic;
using System.IO;
using UnityEngine;

public static class EnvLoader
{
    private static Dictionary<string, string> envValues = new Dictionary<string, string>();

    public static void LoadEnv(string path)
    {
        envValues.Clear();

        if (!File.Exists(path))
        {
            Debug.LogWarning($".env 파일이 존재하지 않습니다: {path}");
            return;
        }

        var lines = File.ReadAllLines(path);
        foreach (var line in lines)
        {
            if (string.IsNullOrWhiteSpace(line) || line.StartsWith("#")) continue;

            var parts = line.Split('=');
            if (parts.Length != 2) continue;

            var key = parts[0].Trim();
            var value = parts[1].Trim();
            envValues[key] = value;
        }

        Debug.Log(".env 파일 로드 완료");
    }

    public static string Get(string key, string defaultValue = "")
    {
        return envValues.TryGetValue(key, out var value) ? value : defaultValue;
    }
}

4. 외부 클래스에서 사용하기

public class UnityWebSocketClient : MonoBehaviour
{
    private static string WebSocketUrl;
    private static string ChannelId;
    private static string PageIdx;

    void Awake()
    {
        EnvLoader.LoadEnv(Application.dataPath + "/.env");

        WebSocketUrl = EnvLoader.Get("WEB_SOCKET_URL", "웹 소켓 URL을 여기에 입력하세요");
        ChannelId = EnvLoader.Get("CHANNEL_ID", "채널 ID를 여기에 입력하세요");
        PageIdx = EnvLoader.Get("PAGE_IDX", "페이지 인덱스를 여기에 입력하세요");

        Debug.Log($"WebSocket URL: {WebSocketUrl}");
    }
}

기타 주의사항

위 방식과 다르게 .env를 Resources 폴더에 넣고, Resources.Load() 를 통해 파싱할 생각이라면, 정상적으로 읽어들이기 위해 마침표를 지우고 확장자를 txt나 json으로 두어야 할 것이다. (ex. "Resoruces/env.txt")

필자의 필요에 의해 만들어보는 미디어 분류 저장을 위한 크롬 확장 프로그램.

기능과 사용 예시는 아래와 같다.

사용 예시

1. 크롬 확장 프로그램의 아이콘을 눌러, 프리셋 이름과 폴더를 지정할 수 있다.

2. 이미지(기타 미디어에도 확장 예정)를 우클릭하면, '이미지를 특정 폴더에 저장' 메뉴가 뜨며, 프리셋으로 지정해놓았던 이름이 있어 해당 위치에 저장하게 된다.

개발 실패를 야기한 문제점

**크롬 정책 상 절대경로 참조를 통한 저장이 불가능하다.**

절대경로 저장을 위해서는, 저장 시점에 직접 폴더를 지정하거나 Native Messaging 외부 프로그램을 사용자가 함께 설치해야한다.
- 직접 폴더지정의 경우는 애초에 설정한 프리셋이 무용지물이 되며 기존 기능인 '이미지를 다른 이름으로 저장...' 과 차이점이 없다.
- Native Messaging 의 경우는 외부 프로그램의 힘을 빌려 연동하는 방식인데, 사용자가 직접 번거롭게 추가 세팅을 해야하는 게 제일 문제이다.

경로를 하드코딩하며 직접 실행 해 보았지만, 역시 기본 다운로드 폴더의 밖을 참조하려고 하면 오류가 발생한다.

즉 알려진 바로는 크롬의 기본 저장위치로부터의 상대경로(저장위치의 자식경로 한정)에만 저장이 가능하며, 이러한 제약사항때문에 확장프로그램의 효용성이 매우 떨어진다.

아직도 변수명명을 일관되지 못하게 하고 있어서 생각난 김에 제대로 정하고 가려고 한다.

앞으로 진행할 개인프로젝트에서도 유의할 것.

일단 GPT 자문을 통해, Unity 스타일과 C# 스타일에도 살짝 차이가 있다고 한다. 일단 차이를 확인 해 보면,

두 스타일이 크게 다르진 않은데,
- private 멤버변수에 'm_'을 붙이느냐(Unity) 아니면 '_'을 붙이거나 아얘 생략하거나(C#) 할 수 있고
- C# 스타일에서는 public 멤버변수는 프로퍼티 사용을 하는 게 기본 스타일이라고 적혀있는데, 더 찾아보지는 않았다. 그리고 C#은 PascalCase를 사용하는 정도.

종종 변수명으로 private const string SERVER_ENDPOINT = "https://api.example.com"; 이렇게 ALL_CAPS의 경우도 보였는데, 이는 C++에서 주로 사용하는 스타일이고 C#에서는 ServerEndpoint 와 같이 PascalCase를 사용하는 게 권장된다고 한다. 또한 static readonly 변수의 경우에 특히 자주 보이는데 이 역시 PascalCase가 일반적으로 사용된다는 듯.
유니티와는 별개로 환경변수 파일에서는 ALL_CAPS 명명이 일반적이었던 것으로 기억한다.

게임개발 사이드라고 하더라도 유지보수에는 C# 스타일이 낫다고 하고, 개인적으로 m_ 명명법이 낯설어서 C# 스타일을 채택해야겠다.

세부 옵션까지는 어렵지만 가능한 모든 메뉴를 만져보면서 익숙해지는 중.

현재 단계에서 이해가 여려운 점

1. 일단 타임라인에서 만든 이슈가, 보드 탭에서 안보이는 이유를 모르겠고 반대로도 보드에서 만든 이슈에 스타트날이랑 기한까지 붙여놓아도 타임라인에서 보이지 않는 점.

2. 이슈 목록에서 보면 타임라인에서 만든 이슈는 '에픽'이고, 유형 보드에서 만든 이슈는 '작업'유형이 붙어있는데 why...

계속 붙어서 익숙해져봐야겠다.