Amazon GameLift 스트림 문제 해결

IAM 역할에 명시적 "모두 거부" 정책이 있는 경우 "gameliftstreams:*" NotAction 요소에를 추가하여 Amazon GameLift Streams를 해당 정책에 대한 예외로 명시적으로 나열해야 합니다. 예제:

{
    "Sid": "DenyAllExceptListedIfNoMFA",
    "Effect": "Deny",
    "NotAction": [
        "iam:CreateVirtualMFADevice",
        "iam:EnableMFADevice",
        "iam:GetUser",
        "iam:ListMFADevices",
        "iam:ListVirtualMFADevices",
        "iam:ResyncMFADevice",
        "sts:GetSessionToken",        
        "gameliftstreams:*"                    // Add this
    ],
    "Resource": "*",
    "Condition": {
        "BoolIfExists": {"aws:MultiFactorAuthPresent": "false"}
    }
}

자세한 내용은 보안 Amazon GameLift Streams의 Identity and Access Management 장의 섹션을 참조하고 IAM 사용 설명서의 액세스 거부 오류 메시지 문제 해결을 참조하세요.

다른 시스템에서 애플리케이션을 실행하여 올바르게 패키징되었는지 확인합니다. 이렇게 하면 애플리케이션 콘텐츠에 하드코딩된 경로, 누락된 자산, 라이브러리 또는 다른 디바이스에서 작동하지 않을 수 있는 바이너리가 포함되지 않습니다.

애플리케이션이 Proton과 호환되는지 확인합니다. Amazon GameLift Streams 서버가 없는 로컬 환경에서 애플리케이션을 테스트하여 Proton과 호환되는지 확인합니다. 지침은 Proton for Amazon GameLift Streams와의 호환성 테스트 및 문제 해결 섹션을 참조하세요.

런타임을 확인합니다. Amazon GameLift Streams 애플리케이션 구성에서 실행 파일 시작 경로에 지정한 파일이 실행 파일 또는 스크립트이고 선택한 런타임 환경에 맞는지 확인합니다. Windows 애플리케이션의 파일 형식은 ".exe", ".bat" 또는 ".cmd"여야 하며 Windows 또는 Proton 런타임을 대상으로 해야 합니다. 네이티브 Linux 애플리케이션은 Ubuntu 22.04 LTS 런타임을 대상으로 하는 실행 파일이어야 합니다.

필요한 DLLs 확인합니다. Windows 애플리케이션에 필수 DLLs. 예를 들어 애플리케이션이 디버그 빌드인 경우 Microsoft C 및 C++(MSVC) 런타임 라이브러리의 디버그 버전이 필요합니다. 이 문제를 해결하려면 빌드와 DLLs side-by-side 패키징하는 것이 좋습니다. 지침은 Microsoft에서 디버그 실행 파일을 실행하기 위한 테스트 머신 준비를 참조하세요.

올바른 실행 파일을 사용합니다. 애플리케이션이 Amazon GameLift Streams에서 올바르게 작동하려면 애플리케이션 경로를 Binaries/Win64/ (또는 유사한) 하위 폴더에 있는 전체 실행 파일로 설정합니다. Unreal Engine은 폴더 루트에 있는 작은 부트스트랩 실행 파일과 Binaries/Win64/ 하위 폴더에 있는 플랫폼 대상 실행 파일이라는 두 가지 실행 파일을 생성합니다. 사전 조건을 검증하려는 루트의 부트스트랩 실행 파일이 올바르고 Amazon GameLift Streams에서 애플리케이션 시작을 방해하는 오탐을 생성할 수 있습니다. 플랫폼 대상 실행 파일이 누락된 경우 애플리케이션이 올바르게 빌드되지 않았을 수 있습니다. 예를 들어 샘플 Unreal 애플리케이션의 다음 폴더 구조를 참조하세요.

BuildApp
|-> MyUnrealApp.exe
|-> MyUnrealApp
            |-> Binaries
                    |-> Win64
                            |-> MyUnrealApp.exe 

Unreal Engine Asserts를 끕니다. check, verify및 ensure 매크로를 비활성화합니다. 애플리케이션이 충돌 덤프를 생성하지 못하게 할 수 있습니다. 자세한 내용은 Unreal Engine 설명서의 어설트를 참조하세요.

시스템에 Amazon GameLift Streams보다 더 강력한 하드웨어가 있을 수 있습니다. Amazon GameLift Streams가 사용하는 하드웨어와 비슷한 성능의 시스템에서 애플리케이션을 테스트해야 합니다.

이렇게 하면 애플리케이션의 렌더링 설정이 GPU와 호환되고 성능이 사용자의 기대치를 충족하는지 확인할 수 있습니다.

문제는 네트워크 연결 또는 Amazon GameLift Streams의 설정 때문일 수 있습니다. 스트림 연결 문제 섹션의 문제 해결 팁을 시도해 보세요.

Unreal Engine 게임은 단원을 참조하십시오Unreal Engine 성능 프로파일링.

드라이버 기반 캐싱 -이 접근 방식은 런타임 환경 GPU 및 드라이버 버전에 따라 다릅니다. 이 옵션은 모든 애플리케이션에 적용할 수 있으므로 기본 권장 접근 방식입니다. 이 접근 방식의 단계는 모든 GPU/드라이버 조합에 대해 복제해야 합니다.

엔진 기반 캐싱 -이 접근 방식은 가능한 경우 게임 엔진을 통한 셰이더 캐싱을 활성화합니다. 개발자가 사전 베이킹된 파이프라인 상태 객체(PSO) 캐시를 생성해야 하는 부담이 있습니다. 또한 엔진이 동일한 GPU 하드웨어의 여러 드라이버에 대한 캐시 지원을 처리할 수 있다고 가정합니다.

최종 사용자에게 AWS 리전 가장 가까운를 선택합니다. 클라이언트에서 스트림을 호스팅하는 리전까지의 지연 시간이 길면 스트림 품질에 영향을 미칠 수 있습니다. 스트리밍할 수 있는 위치 AWS 리전 Amazon GameLift Streams에서 지원하는 및 스트리밍 위치 목록은 섹션을 참조하세요. 리전에서 AWS 콘솔 엔드포인트를 ping하여 대략적인 지연 시간 측정값을 얻을 수 있습니다.

스트림 그룹에 새 스트림에 대한 용량이 있는지 확인합니다.

최종 사용자가 웹 클라이언트 시간이 초과되기 전에 연결할 수 있도록 ConnectionTimeoutSeconds가 충분히 설정되어 있는지 확인합니다.

방화벽이 UDP 포트 범위 33435-33465에 대한 액세스를 허용하여 Amazon GameLift Streams에서 스트리밍을 허용하는지 확인합니다. Amazon GameLift Streams가 이러한 포트에 연결할 수 없는 경우 검은색 또는 회색 화면과 같은 스트리밍 문제가 발생할 수 있습니다.

인터넷 연결이 1080p 스트림에 대해 10Mbps 이상의 연결 속도를 유지할 수 있는지 확인합니다. Amazon GameLift Streams에서 재생하는 동안 네트워크 문제를 감지하면 인터넷 속도가 변동하고 최소 10Mbps를 일관되게 얻지 못할 수 있습니다. 인터넷 속도 테스트를 실행하고 문제 해결 단계를 계속 진행합니다.

가능하면 유선 네트워크를 사용합니다. Wi-Fi를 사용할 때는 더 강력한 신호 강도를 위해 디바이스를 라우터 가까이로 이동합니다.

2.4GHz 및 5GHz 대역 모두에서 Wi-Fi 라우터를 사용하는 경우 다른 대역에 연결해 보세요. 라우터를 다른 밴드로 전환하는 방법을 잘 모르는 경우 Wi-Fi 라우터의 제조업체 또는 공급자의 지원 페이지를 방문하세요. 고객 서비스에 문의할 수도 있습니다.

동일한 네트워크(특히 홈 Wi-Fi)에 있는 다른 사용자가 비디오 스트리밍, 다운로드, 온라인 게임 또는 백업과 같은 고대역폭 애플리케이션을 실행하고 있는지 확인합니다.

디바이스에서 대역폭을 차지하는 다른 애플리케이션을 닫습니다.

스트리밍 중에는 VPN 또는 프록시를 사용하지 마십시오. 지연 시간이 길어지고 게임 플레이에 영향을 미칠 수 있습니다.

iPad 또는 iPhone에서 재생할 때 셀룰러 네트워크 대신 Wi-Fi를 사용하고 있는지 확인합니다. 셀룰러 네트워크를 사용하면 연결 문제가 발생할 수 있습니다.

MacOS 사용자는 위치 서비스를 비활성화해야 합니다. 그러면 Wi-Fi가 때때로 일시 중지되어 스트리밍 환경이 저하됩니다.

테스트하여 문제가 브라우저 지정인지 확인합니다. 전반적으로 최상의 최종 사용자 경험과 특히 게임 컨트롤러와의 호환성을 극대화하려면 Google Chrome, Microsoft Edge 또는 사용자 지정 Chromium 기반 데스크톱 애플리케이션을 사용하는 것이 좋습니다.

클라이언트에서 전송하고 애플리케이션에서 수신한 입력 이벤트를 로깅하여 프런트 엔드 코드에 입력 불일치가 있는 위치를 식별합니다.

알려진 문제 및 제한 사항을 포함하여 지원되는 브라우저 및 입력 디바이스에 대한 지원되는 브라우저 및 입력 추가 정보를 확인해야 합니다.

문제: MacOS의 명령 키는 Microsoft Windows의 Windows 키에 매핑되는 Meta 키 이벤트에 매핑됩니다. 이 문제는 명령과 다른 키를 동시에 누를 때 MacOS 브라우저에 영향을 미치는 버그입니다. 여기서 Meta 키는 해제될 때 재설정되지만 브라우저가 화살표 키에 대한 키업 이벤트를 캡처하지 않았기 때문에 화살표 키는 재설정되지 않으므로 웹 SDK 클라이언트가 서버에 키업 이벤트를 보내지 않고 스트리밍 애플리케이션은 여전히 키가 눌러지고 있다고 생각할 것입니다.

해결 방법: 명령 키를 사용하지 않는 경우 웹 SDK의 InputConfiguration 인터페이스에 있는 웹 SDK 키보드 필터 메커니즘(keyboardFilter)을 사용하여 필터링할 수 있습니다.

문제: 특정 OS 수준 UI 요소(예: 데스크톱의 브라우저 메뉴 모음 또는 iOS의 Control Center 및 Notification Center)를 열면 브라우저가 블러 또는 포커스 이벤트를 트리거하지 않고 입력 이벤트 실행을 중지합니다. 이렇게 하면 서버가 마지막 입력 상태를 계속 수신합니다. 이는 안정적으로 감지할 수 없는 브라우저 수준 제한입니다.

해결 방법: 데스크톱 브라우저에서 전체 화면 모드를 사용하여 브라우저 메뉴 표시줄에 대한 액세스를 방지합니다. 키보드가 연결된 iOS 사용자의 경우 네이티브 앱이 포커스 손실을 더 잘 감지하고 처리할 수 있는 웹 보기로 네이티브 앱 래퍼를 생성하여 브라우저 창 포커스 및 블러 이벤트를 명시적으로 트리거하는 것이 좋습니다. 또는 프런트 엔드 HTML 또는 게임 내 UI 요소를 사용하여 사용자에게 키가 여전히 눌러져 있음을 알리고이 iOS 제한에 대한 정보를 제공합니다.

문제: Amazon GameLift Streams는 휴리스틱을 사용하여 마우스 이벤트를 “상대적” 또는 “절대적” 모드로 전송할지 여부를 선택합니다. 상대 모드에서 새 마우스 업데이트는 이전 업데이트와 작은 증분 차이로 제공됩니다. 절대 모드에서 마우스 커서는 클라이언트와 동기화된 화면 위치로 계속 강제됩니다. 스트리밍된 콘텐츠 위에 운영 체제 커서가 표시되면 휴리스틱은 항상 절대 좌표를 선택합니다. 이로 인해 애플리케이션이 작고 상대적인 업데이트를 기대하는 경우 예기치 않게 큰 이동 델타가 발생할 수 있습니다.

해결 방법: 애플리케이션에서 상대적 마우스 모션(예: FPS 스타일 카메라 제어 또는 드래그 기반 상호 작용)이 필요한 경우 마우스 상호 작용 중에 운영 체제 커서를 숨깁니다. 예를 들어 마우스 아래로 커서를 숨기고 마우스 위로 다시 표시합니다. 이렇게 하면 끌기 모션이 상대 좌표를 사용하고 버튼을 놓을 때만 절대 위치가 동기화됩니다.

애플리케이션이 중단되거나 충돌합니다. 문제 해결 지침은 애플리케이션 문제 섹션을 참조하세요.

스트림 그룹 상태가이 아닙니다Active. 스트림 그룹의 상태를 확인합니다.

온디맨드 용량이 StartStreamSession API에서 ConnectionTimeoutSeconds에 지정된 제한 시간보다 오래 걸립니다. Windows 런타임에서 온디맨드 스핀 업 시간은 5분 이상 걸릴 수 있습니다.

스트리밍 위치에 사용 가능한 용량이 없습니다. 할당된 용량이 사용 중인 용량보다 크거나 사용 중이 아닌 온디맨드 용량이 있는지 확인합니다(할당된 용량이 항상 켜져 있는 용량 + 온디맨드 용량보다 작음). 콘솔의 스트림 그룹 목록 또는 스트림 그룹 세부 정보 페이지에서 이러한 값을 찾을 수 있습니다. 서비스 API를 사용하면 GetStreamGroup을 사용하여 이러한 값을 찾을 수 있습니다. 사용 가능한 용량이 일시적으로 0인 몇 가지 시나리오는 다음과 같습니다.

네트워크 조건이 너무 좋지 않아 프레임, 특히 첫 번째 프레임이 전송되지 않습니다. 클라이언트와 스트리밍 위치 간의 네트워크 상태를 확인하고 다른 위치를 조정하거나 시도합니다.

배치 제한 시간: Amazon GameLift Streams가 스트림 세션을 호스팅할 컴퓨팅 리소스를 찾는 제한 시간 값입니다.

연결 제한 시간: 클라이언트가 스트림 세션에 연결하거나 다시 연결하는 제한 시간 값입니다.

유휴 제한 시간: 사용자 입력 없이 스트림 세션을 유휴 상태로 유지할 수 있는 최대 시간입니다.

세션 길이 제한 시간: 스트림 세션의 최대 시간입니다.