추가 가이드

now.gg의 서비스와 API를 편리하게 설정 및 적용하는 데 도움이 될 만한 Cloud와 관련된 추가 가이드입니다.

추가 가이드

아래를 참조해 주시기 바랍니다:

• 유저 상태 저장을 위한 클라우드 스토리지 설정
• 앱 파일 준비
• 커스텀 도메인 추가 및 구성
• now.gg CLI를 통한 앱 업로드
• 구독 이해하기
• 임베드 모듈로 웹사이트에서 클라우드 게임 플레이 활성화
• now.gg에서 게임을 실행하기 위한 호스트 시스템 및 브라우저 요구 사항

유저 상태 저장을 위한 클라우드 스토리지 설정

이때 저장 파일 경로와 제외 파일 경로를 정의하여 유저의 게임 진행 데이터를 저장하고 복원하기 위한 now.gg 클라우드 스토리지를 설정하실 수 있습니다.

‘저장’ 및 ‘제외’ 파일 경로를 정의하는 것은 게임 로딩 시간을 줄여 유저의 플레이 경험을 향상하고 now.gg 클라우드 스토리지를 최적으로 사용하는 필수 방법 중 하나입니다.

스토리지 설정 요구 사항:

• 저장 파일 경로
  클라우드에 저장할 파일이나 폴더의 위치를 나타내며 일반적으로 /data/data/<package_name>/<file_name>에 저장됩니다.
• 제외 파일 경로
  클라우드에 저장하지 않을 파일 및 폴더의 위치를 나타냅니다.

파일 경로 설정

현재 now.gg에서 새로 출시하는 모든 앱에 대해 해당 설정을 적용하실 수 있으며 이미 출시된 앱의 경우 새 버전의 앱을 출시해야 합니다.

방법:

• nowStudio에 로그인합니다.
• 선택:
  • 새 앱 추가
    • 여기를 따라 새 앱을 추가합니다.
  • 새 버전 출시
    • 여기를 따라 새 버전을 출시합니다.
• ‘앱 콘텐츠’ 탭에서:
  • 저장 파일 경로 및 제외 파일 경로를 입력합니다.
    
  • 저장을 클릭합니다.
• 왼쪽 메뉴에서 릴리스를 클릭합니다.
  • 릴리스를 생성합니다.

설명:

• 파일 경로가 여러 개인 경우 공백이나 쉼표 대신 새 줄로 각 경로를 구분합니다.
• 저장 파일 경로의 경우 지정한 파일과 폴더만 다음 플레이 세션을 위해 저장되고 복원됩니다.
• 제외 파일 경로(선택 사항)의 경우 지정한 파일과 폴더가 클라우드에 저장되지 않습니다.

앱 파일 준비

nowStudio에 업로드할 앱 파일을 준비합니다.

nowStudio를 사용하여 릴리스를 생성하려면 앱 파일을 준비해야 하며 이때 Standalone(독립형) APK, APK 및 에셋 Zip 파일이 허용됩니다.

{
    "assets": [
        {    
            "name": "asset1.xyz",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "asset2.unity3d",
            "location": "/data/media/0/Android/data/<packageName>/files"
        },
        {
            "name": "OtherAssets",
            "location": "/data/data/<packageName>/files"
        }
    ]
}

커스텀 도메인 추가 및 구성

now.gg가 아닌 다른 도메인에 앱을 호스팅하려는 경우 커스텀 도메인을 추가하는 과정입니다.

now.gg 클라우드 외에도 커스텀 도메인을 추가하여 다른 도메인에서 앱을 호스팅하실 수도 있습니다.

시나리오:

• 새 앱에 커스텀 도메인 추가
• 이미 출시된 앱에 커스텀 도메인 추가

1. 새 앱에 커스텀 도메인 추가

새 앱에 커스텀 도메인을 추가하는 단계입니다.

방법:

• 새 앱을 추가합니다.
• 모든 앱에서 앱을 선택합니다.
  • 앱 이름 옆에 있는 세부 정보를 클릭합니다.
• 프로덕션 내의 정보를 클릭합니다.
• 아래와 같이 해당 필드에 커스텀 도메인 주소를 입력합니다.
  
  중요: 추가하려는 도메인을 소유하고 있는지 확인해 주시기 바랍니다.
• 기타 필수 세부 정보를 입력했는지 확인합니다.
• 저장을 클릭합니다.
  • 입력된 도메인 정보는 검토되며 컨펌 후 도메인 매핑을 계속 진행하실 수 있습니다.
• 필요한 앱 세부 정보를 모두 입력한 후 릴리스를 생성하실 수 있습니다.
• 매핑 세부 정보를 받은 후 아래와 같이 ‘정보‘ 탭 내 ‘매핑 세부 정보‘를 클릭하면 해당 정보를 확인하실 수 있습니다.
  
• 아래와 같이 도메인 매핑 세부 정보가 제공됩니다.
  
• 제공된 세부 정보를 통해 DNS 공급자를 설정하실 수 있습니다.
• DNS 공급자를 통해 설정 후 해당 도메인에서 게임을 호스팅하실 수 있습니다.

2. 이미 출시된 앱에 커스텀 도메인 추가

이미 출시된 앱에 커스텀 도메인을 추가하는 단계입니다.

방법:

• 모든 앱에서 앱을 선택합니다.
  • 앱 이름 옆에 있는 세부 정보를 클릭합니다.
• 프로덕션 내의 정보를 클릭합니다.
• 오른쪽 하단의 수정 버튼을 클릭합니다.
  (이후 필드를 수정하실 수 있습니다)
• 아래와 같이 해당 필드에 커스텀 도메인 주소를 입력합니다.
  
  중요: 추가하려는 도메인을 소유하고 있는지 확인해 주시기 바랍니다.
• 저장을 클릭합니다.
• 아래와 같이 확인 메시지가 화면에 표시됩니다.
  
• 입력된 도메인 정보는 검토되며 컨펌 후 도메인 매핑을 계속 진행하실 수 있습니다.
• 매핑 세부 정보를 받은 후 아래와 같이 ‘정보‘ 탭 내 ‘매핑 세부 정보‘를 클릭하면 해당 정보를 확인하실 수 있습니다.
  
• 아래와 같이 도메인 매핑 세부 정보가 제공됩니다.
  
• 제공된 세부 정보를 통해 DNS 공급자를 설정하실 수 있습니다.
• DNS 공급자를 통해 설정 후 해당 도메인에서 게임을 호스팅하실 수 있습니다.

CLI를 통한 앱 업로드

nowgg CLI는 앱 빌드를 nowStudio에 쉽게 업로드할 수 있게 도와주는 커맨드 라인 도구입니다.

nowgg CLI

macOS 또는 Windows에서 터미널을 실행합니다.

설치 및 초기화

  pip install nowgg

  nowgg init --token "<your_publisherToken_from_nowStudio>"

nowgg CLI로 nowStudio에 앱 업로드

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <app_version_name> --version_code <app_version_code>

  nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <apk_version> --version_code <app_version_code> --deploy 

지원

  nowgg -h
   nowgg init -h
   nowgg upload -h

구독 이해하기

다음 문서는 nowStudio에서 제공하는 구독 기능의 중요한 측면에 초점을 맞춥니다.

구독은 now.gg에서 제공하는 앱 내 상품으로, 사용자에게 내 앱의 콘텐츠나 서비스에 접근할 수 있는 정기 요금을 부과합니다.

nowStudio는 ‘구독’ 기능을 통해 구독을 쉽게 생성, 관리 및 판매할 수 있는 다양한 기능을 제공합니다. 앱 내 상품과 구독 상품의 주요 차이점은 앱 내 상품은 사용자에게 일회성 요금이 부과되지만, 구독은 정기적인 요금이 부과된다는 점입니다.

nowStudio에서 구독을 생성하고 관리하는 방법을 이해하기 위해서는:

• 구독 생성 및 관리 섹션을 참조하세요.

now.gg 결제 모듈을 사용하여 앱에서 구독을 구현하는 방법을 이해하기 위해서는 다음 가이드를 따르세요:

• Unity
• 네이티브 안드로이드

중요: 이 페이지의 정보 외에도 now.gg 정책을 참조해야 합니다.

구독 개요

이 섹션에서는 구독에 대해 소개합니다.

• 구독
• 청구 기간
  • 자동 갱신
• 혜택
• 가격
  • 가격 변경

구독

구독은 사용자가 특정 기간 동안 접근할 수 있는 혜택의 집합을 제공합니다. 같은 앱 내에서 여러 구독을 가질 수 있어 다른 혜택 세트나 단일 혜택 세트의 다양한 계층을 나타낼 수 있습니다(예: ‘골드’ 및 ‘다이아몬드’ 팩). 사용자는 now.gg 앱 내에서 구매함으로써 구독에 접근할 수 있습니다.

청구 기간

now.gg에서는 구독 기간을 선택할 수 있습니다. 가능한 청구 기간은 다음과 같습니다:

• 4주마다
• 월간
• 2개월마다
• 3개월마다
• 4개월마다
• 6개월마다
• 8개월마다
• 연간

혜택

구독에 최대 네 가지 혜택을 추가할 수 있어 사용자가 받게 될 핵심 혜택을 강조해야 합니다.

결제 거절

갱신 결제가 거절되면 now.gg는 사용자에게 결제 문제를 해결하도록 요구합니다. 해결되지 않을 경우 구독이 자동으로 만료됩니다.

임베드 모듈로 웹사이트에서 클라우드 게임 플레이 활성화

now.gg Embed Javascript 모듈는 프레임워크를 제공함으로써 개발자분들이 웹사이트에 클라우드 게임을 더욱 쉽게 임베딩(삽입, 첨부, 추가)하실 수 있도록 도와드립니다.

now.gg 임베드 모듈

• 웹페이지에 클라우드 게임 간편히 임베딩
• 클라우드 앱 또는 게임이 임베딩된 웹페이지 내 이벤트 기반 통신 가능
• 웹사이트 내 임베딩된 클라우드 게임으로 더욱 쉽게, 많은 유저 확보 및 유지 가능

요구사항

now.gg 임베드 모듈를 사용하기 위해서는 아래 전제 조건이 충족되어야 합니다.

• 화이트 도메인 – now.gg 임베드 모듈는 now.gg의 도메인 허용 목록에 추가된 도메인에서만 작동하므로 사용하시려는 도메인을 dev-support@now.gg로 보내 주시기 바랍니다.
• clientId (클라이언트 ID) – clientId를 발급받기 위해 dev-support@now.gg로 문의해 주세요.
• appId (앱 ID) – appId를 발급받기 위해 여기를 읽어 주세요.

이후 여기를 통해 웹페이지에 클라우드 게임을 임베딩해 보실 수 있습니다.

임베드 모듈 구현

now.gg 임베드 모듈 적용 단계입니다.

방법:

1. 웹사이트에 임베드 모듈를 추가합니다.
2. Iframe에서 게임을 실행합니다.
3. 추가로 다음을 통해 고급 임베딩 기능을 추가해 보실 수 있습니다.

<script type="text/javascript" src="https://cdn.now.gg/external/sdk/ifp-sdk-1.1.0.min.js"></script>

const iframeParentElement = document.getElementById("your_iframe_element");

// 안드로이드 앱에서 전송된 이벤트를 처리하는 콜백 함수입니다.
const appEventCallbackFunction = (event) => {
    console.log(event.name); 
    console.log(event.data);
    // 여기에서 받은 이벤트를 처리합니다.
}; 

// JavaScript 모듈 이벤트를 처리하는 콜백 함수입니다.
const sdkEventCallbackFunction = (event) => {
    console.log(event.name); 
    console.log(event.msg);
    // 여기에서 받은 이벤트를 처리합니다.
}; 


NowIfp.init({
    clientId: <"your_clientId"> ,
    appId: <"your_production_appId/your_test_track_appId"> , \\ appId 예 - 테스트 트랙: "1234_t1" | 프로덕션: "1234"
    iframeParentElement: iframeParentElement,
    customData: {} // for app-specific custom handling
    appLaunchData: {
        // 실행 관련 변수를 Iframe에 전달하면 실행 시 직렬화(serialized)되어 앱에 전달됩니다.
        [key]: [value]
    } 
    appEventCallback: appEventCallbackFunction,
    sdkEventCallback: sdkEventCallbackFunction,
    isNowLoginEnabled: true
});

임베딩 고급 기능

웹사이트(HTML)에 임베딩된 게임에 고급 기능을 적용하는 단계입니다.

클라우드 게임 환경을 구축하기 위해 now.gg 임베드 모듈를 사용할 시

• 클라우드 내 앱 이벤트와 데이터를 HTML 페이지로 전달할 수 있습니다.
• 앱 실행 변수를 앱에 전달할 수 있습니다.

요구사항

• now.gg 이벤트 모듈을 다운로드하고 안드로이드 앱에 적용합니다.

1. 앱 이벤트를 HTML 페이지로 전달

now.gg 이벤트 모듈 적용 시 now.gg 클라우드에 있는 앱의 이벤트와 데이터를 게임이 임베딩된 HTML 페이지로 전달할 수 있습니다.

참조 :

•  이벤트 및 데이터 HTML 페이지로 전달 (이벤트 모듈)
  • Unity
  • Native Android

2. HTML 페이지의 변수를 앱에 전달

NowIfp.init에 전달될 appLaunchData를 선언한 뒤 앱으로 전달할 수 있는 아래 샘플 코드를 통해 HTML 페이지에서 앱 실행 변수를 앱에 전달하실 수 있습니다.

NowIfp.init({
     clientId: <"your_clientId"> ,
     appId: <"your_appId"> ,
     iframeParentElement: iframeParentElement,
     customData: {} // 앱별 필요한 커스텀 작업이 가능
     appLaunchData: {
           [key]: [value]
     } 
      // 실행 시 Iframe에 실행 변수를 전달합니다. 이때 해당 변수는 직렬화(serialized)되어 전달됩니다.
     appEventCallback: appEventCallbackFunction,
     sdkEventCallback: sdkEventCallbackFunction,
     isNowLoginEnabled: true
 });

// 앱 실행 변수로 전달된 키를 사용하여 값을 검색 및 수령합니다.
 string value = NowGGEventsSdkManager.Instance.GetAppLaunchDataProperty(key);

데모 프로젝트

데모 HTML 페이지를 통해 Embed 모듈의 작동 방식을 한눈에 확인해 보실 수 있습니다.

Embed 모듈 작동 방식

• 이곳을 통해 now.gg Embed 모듈 Demo를 실행합니다.
  
• Embed 데모 :
• App 실행 데이터
  • + 버튼을 클릭하여 appLaunchData를 추가합니다.
    
• 키/값을 입력합니다.
• 모듈 초기화
  • Embed 모듈 초기화 버튼을 클릭하면 모듈가 초기화되고 클라우드 게임이 실행됩니다.
  • 초기화 이벤트는 아래와 같이 sdkEventCallback으로 관리하실 수 있습니다.
    
  • 성공적으로 초기화될 시 아래와 같이 임베딩된 게임이 실행되기 시작합니다.
  • 

• 유니티에서 HTML(웹 클라이언트)로 데이터 전달
  • 링크 열기
    • 링크 열기 버튼을 누르면 제공된 링크가 새 탭에서 열립니다.
  • 브라우저 이벤트
    • 브라우저 이벤트 버튼을 누르면 유니티에서 HTML 페이지로 데이터를 전송합니다.
    • 앱 이벤트는 아래와 같이 appEventCallback 함수에 의해 관리됩니다.