Google. Android. PerformanceTuner. AndroidPerformanceTuner< TFidelity, TAnnotation >
Android Performance Tuner를 설정하고 실행하기 위해 인스턴스화할 기본 클래스입니다.
요약
세부정보 | |||||
---|---|---|---|---|---|
템플릿 매개변수 |
|
공개 속성 |
|
---|---|
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/' 폴더에서 충실도 매개변수를 로드합니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
||
반환 |
성공적으로 로드된 경우 충실도 매개변수를 반환합니다.
|
Flush
ErrorCode Flush()
현재 히스토그램을 강제로 업로드합니다.
세부정보 | |
---|---|
반환 |
업로드가 시작될 수 있는 경우 ErrorCode.Ok를 반환합니다.
이 업로드를 차단하는 이전 업로드가 있는 경우 ErrorCode.PreviousUploadPending을 반환합니다.
이전 업로드 이후 1분 미만이 경과한 경우 ErrorCode.UploadTooFrequent를 반환합니다.
|
FrameTick
ErrorCode FrameTick( InstrumentationKeys key )
계측 키 및 현재 주석과 연결될 프레임 틱을 기록합니다.
고급 모드와 기본 모드의 경우 모두 FrameTick이 자동으로 호출됩니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
||
반환 |
계측 키가 잘못된 경우 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'에 전송됩니다.
세부정보 | |||||
---|---|---|---|---|---|
매개변수 |
|
||||
반환 |
매개변수를 다운로드하기 전에 먼저 시간 초과가 발생하면 ErrorCode.Timeout을 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.
|
SetCurrentAnnotation
ErrorCode SetCurrentAnnotation( TAnnotation annotation )
현재 주석을 설정합니다.
맞춤 주석에만 사용합니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
||
반환 |
플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 기본 주석 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다. 주석이 설정과 일치하지 않거나 잘못된 값이 설정된 경우 ErrorCode.InvalidAnnotation을 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.
|
SetFidelityParameters
ErrorCode SetFidelityParameters( TFidelity fidelityParams )
현재 활성 충실도 매개변수를 설정합니다.
이 함수는 실험 모드에서 다운로드된 모든 매개변수를 재정의합니다. 예를 들어 플레이어가 게임 품질 설정을 수동으로 변경한 때에 이 함수를 사용합니다. 이 함수는 이전 매개변수와 관련된 모든 데이터를 플러시(즉, 업로드)합니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
||
반환 |
매개변수를 설정할 수 있다면 ErrorCode.Ok를 반환합니다. 메시지에 잘못된 값이 있다면 ErrorCode.InvalidFidelity를 반환합니다. 플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 기본 충실도 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다.
|
SetLoadingState
ErrorCode SetLoadingState( MessageUtil.LoadingState state )
로드 상태를 설정합니다.
기본 주석에만 사용합니다. 로드가 시작될 때 MessageUtil.LoadingState.Loading을 설정합니다.
중요:
- 로드가 완료될 때 MessageUtil.LoadingState.NotLoading을 설정하는 것을 잊지 말아야 합니다.
- 로드되는 동안에는 프레임 정보가 기록되지 않습니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
||
반환 |
플러그인이 초기화되지 않은 경우 ErrorCode.TuningforkNotInitialized를 반환합니다. 맞춤 주석 모드로 사용하는 경우 ErrorCode.InvalidMode를 반환합니다. 성공 시 ErrorCode.Ok를 반환합니다.
|
Start
ErrorCode Start()
Stop
ErrorCode Stop()
SwappyIsEnabled
bool SwappyIsEnabled()
swappy가 사용 설정되었는지 여부를 반환합니다.
Editor(편집기)에서 swappy를 사용 설정하려면 Project Settings(프로젝트 설정) -> Player(플레이어) -> Resolution and Presentation(해상도 및 프레젠테이션)으로 이동하여 Optimized Frame Pacing(최적화된 프레임 속도)을 활성화합니다. 더 나은 프레임 속도를 달성하려면 swappy를 사용 설정하는 것이 좋습니다.
세부정보 | |
---|---|
반환 |
swappy가 사용 설정된 경우 True
|