Google.Android.PerformanceTuner.AndroidPerformanceTuner< TFidelity, TAnnotation >

Android Performance Tuner를 설정하고 실행하기 위해 인스턴스화할 기본 클래스입니다.

요약

세부정보
템플릿 매개변수
TFidelity
플러그인에 의해 생성된 FidelityParams 메시지 클래스입니다.
TAnnotation
플러그인에 의해 생성된 주석 메시지 클래스입니다.

공개 속성
onReceiveFidelityParameters
Action< TFidelity >
새 충실도 매개변수가 설정될 때마다 호출되는 작업입니다.
onReceiveUploadLog
Action< UploadTelemetryRequest >
로그가 업로드될 때마다 호출되는 작업입니다.

공개 함수
EnableLocalEndpoint()
로컬 엔드포인트를 사용 설정합니다.
FindFidelityParametersInApk(string filename)
Result< TFidelity >
APK 'assets/tuningfork/' 폴더에서 충실도 매개변수를 로드합니다.
Flush()
현재 히스토그램을 강제로 업로드합니다.
FrameTick(InstrumentationKeys key)
계측 키 및 현재 주석과 연결될 프레임 틱을 기록합니다.
GetFidelityParameters(TFidelity defaultFidelity, uint initialTimeoutMs)
Result< TFidelity >
서버에서 충실도 매개변수를 가져오는 차단 호출입니다.
SetCurrentAnnotation(TAnnotation annotation)
현재 주석을 설정합니다.
SetFidelityParameters(TFidelity fidelityParams)
현재 활성 충실도 매개변수를 설정합니다.
SetLoadingState(MessageUtil.LoadingState state)
로드 상태를 설정합니다.
Start()
AndroidPerformanceTuner를 시작합니다.
Stop()
Android Performance Tuner를 중지합니다.
SwappyIsEnabled()
bool
swappy가 사용 설정되었는지 여부를 반환합니다.

공개 속성

onReceiveFidelityParameters

Action< TFidelity > onReceiveFidelityParameters

새 충실도 매개변수가 설정될 때마다 호출되는 작업입니다.

onReceiveUploadLog

Action< UploadTelemetryRequest > onReceiveUploadLog

로그가 업로드될 때마다 호출되는 작업입니다.

공개 함수

EnableLocalEndpoint

ErrorCode EnableLocalEndpoint()

로컬 엔드포인트를 사용 설정합니다.

디버그 빌드에만 사용할 수 있습니다. 로컬 엔드포인트 사용 설정 방법에 관한 자세한 내용은 README 또는 통합 가이드를 확인하세요.

세부정보
반환
디버그 빌드가 아닌 빌드에서 사용할 경우 ErrorCode.InvalidMode를 반환합니다.

FindFidelityParametersInApk

Result< TFidelity > FindFidelityParametersInApk(
  string filename
)

APK 'assets/tuningfork/' 폴더에서 충실도 매개변수를 로드합니다.

세부정보
매개변수
filename
파일 이름
반환
성공적으로 로드된 경우 충실도 매개변수를 반환합니다.

Flush

ErrorCode Flush()

현재 히스토그램을 강제로 업로드합니다.

세부정보
반환
업로드가 시작될 수 있는 경우 ErrorCode.Ok를 반환합니다.
이 업로드를 차단하는 이전 업로드가 있는 경우 ErrorCode.PreviousUploadPending을 반환합니다.
이전 업로드 이후 1분 미만이 경과한 경우 ErrorCode.UploadTooFrequent를 반환합니다.

FrameTick

ErrorCode FrameTick(
  InstrumentationKeys key
)

계측 키 및 현재 주석과 연결될 프레임 틱을 기록합니다.

고급 모드와 기본 모드의 경우 모두 FrameTick이 자동으로 호출됩니다.

세부정보
매개변수
key
계측 키입니다.
반환
계측 키가 잘못된 경우 ErrorCode.InvalidInstrumentKey를 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.

GetFidelityParameters

Result< TFidelity > GetFidelityParameters(
  TFidelity defaultFidelity,
  uint initialTimeoutMs
)

서버에서 충실도 매개변수를 가져오는 차단 호출입니다.

TuningFork_init에 설정의 일부로 fidelity_params_callback을 전달한다면 이 함수를 호출할 필요가 없습니다. 충실도 매개변수가 다운로드되면 타이밍 정보가 이러한 매개변수와 연결된 것으로 기록됩니다. 이후에 GetFidelityParameters를 호출하고 새 매개변수 집합을 다운로드하면 이미 수집된 모든 데이터가 백엔드에 제출됩니다. 매개변수 요청은 url_base + 'applications/' + package_name + '/apks/' + version_number + ':generateTuningParameters'에 전송됩니다.

세부정보
매개변수
defaultFidelity
다운로드할 수 있는 매개변수가 없다면 이 매개변수는 현재 상태로 간주됩니다.
initialTimeoutMs
연결할 수 없을 때 이 호출에서 반환하기 전에 대기할 시간입니다.
반환
매개변수를 다운로드하기 전에 먼저 시간 초과가 발생하면 ErrorCode.Timeout을 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.

SetCurrentAnnotation

ErrorCode SetCurrentAnnotation(
  TAnnotation annotation
)

현재 주석을 설정합니다.

맞춤 주석에만 사용합니다.

세부정보
매개변수
annotation
현재 주석입니다.
반환
플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 기본 주석 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다. 주석이 설정과 일치하지 않거나 잘못된 값이 설정된 경우 ErrorCode.InvalidAnnotation을 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.

SetFidelityParameters

ErrorCode SetFidelityParameters(
  TFidelity fidelityParams
)

현재 활성 충실도 매개변수를 설정합니다.

이 함수는 실험 모드에서 다운로드된 모든 매개변수를 재정의합니다. 예를 들어 플레이어가 게임 품질 설정을 수동으로 변경한 때에 이 함수를 사용합니다. 이 함수는 이전 매개변수와 관련된 모든 데이터를 플러시(즉, 업로드)합니다.

세부정보
매개변수
fidelityParams
새 충실도 매개변수
반환
매개변수를 설정할 수 있다면 ErrorCode.Ok를 반환합니다. 메시지에 잘못된 값이 있다면 ErrorCode.InvalidFidelity를 반환합니다. 플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 기본 충실도 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다.

SetLoadingState

ErrorCode SetLoadingState(
  MessageUtil.LoadingState state
)

로드 상태를 설정합니다.

기본 주석에만 사용합니다. 로드가 시작될 때 MessageUtil.LoadingState.Loading을 설정합니다.
중요:

  • 로드가 완료될 때 MessageUtil.LoadingState.NotLoading을 설정하는 것을 잊지 말아야 합니다.
  • 로드되는 동안에는 프레임 정보가 기록되지 않습니다.

세부정보
매개변수
state
로드 상태
반환
플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 맞춤 주석 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.

Start

ErrorCode Start()

AndroidPerformanceTuner를 시작합니다.

세부정보
반환
Android Performance Tuner 라이브러리에서 반환된 코드

Stop

ErrorCode Stop()

Android Performance Tuner를 중지합니다.

세부정보
반환
Android Performance Tuner 라이브러리에서 반환된 코드

SwappyIsEnabled

bool SwappyIsEnabled()

swappy가 사용 설정되었는지 여부를 반환합니다.

Editor(편집기)에서 swappy를 사용 설정하려면 Project Settings(프로젝트 설정) -> Player(플레이어) -> Resolution and Presentation(해상도 및 프레젠테이션)으로 이동하여 Optimized Frame Pacing(최적화된 프레임 속도)을 활성화합니다. 더 나은 프레임 속도를 달성하려면 swappy를 사용 설정하는 것이 좋습니다.

세부정보
반환
swappy가 사용 설정된 경우 True