추가 가이드

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.2.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 Embed Module을 사용하면 임베딩된 게임의 플레이 경험을 다음과 같이 향상시킬 수 있습니다:

• now.gg Cloud의 앱에서 HTML 페이지로 이벤트와 데이터를 전달합니다.
• 앱 실행 시 실행 매개변수를 앱으로 전달합니다.
• HTML 페이지에서 앱으로 이벤트와 데이터를 전달합니다.

사전 준비 사항

• now.gg Events 모듈을 Android 앱에 다운로드하여 통합하세요.

NowIfp.init({
     clientId: <"your_clientId">,
     appId: <"your_appId">,
     iframeParentElement: iframeParentElement,
     customData: {}, // 앱별 사용자 지정 처리
     appLaunchData: {
           [key]: [value]
     }, // 실행 시 매개변수 전달
     appEventCallback: appEventCallbackFunction,
     sdkEventCallback: sdkEventCallbackFunction,
     isNowLoginEnabled: true
 });

const sendEventToApp = () => {
     const eventName = 'CustomEvent';
     const eventData = JSON.stringify({
         Sample: 'case'
     });
     NowIfp.sendEventToApp(eventName, eventData);
 };

데모 프로젝트

이 섹션에서는 now.gg Embed Module의 데모 HTML 페이지를 소개하고 Embed Module과 관련된 엔드 투 엔드 플로우를 설명합니다.

아래 단계를 따라 Embed Module 데모를 확인하세요:

• 여기를 클릭하여 now.gg Embed Module 데모를 실행하세요.
• 앱 실행 데이터 전달
  • 실행 의도에appLaunchData를 추가하려면:
  • + 버튼을 클릭하세요.
  • 키와값 필드를 통해 입력할 수 있습니다.
• 모듈 초기화
  • Embed Module 초기화 버튼을 클릭하여 모듈을 초기화하고 클라우드 게임을 실행하세요.
  • 초기화 이벤트는 아래에 표시된 것처럼 sdkEventCallback으로 캡처됩니다.
  • 초기화가 성공하면 임베디드 게임이 실행됩니다.
• 앱으로 이벤트 전송
  • 앱으로 이벤트 전송 버튼을 클릭하여 사용자 지정 이벤트 및 관련 데이터를 앱에 전송합니다.