FleetEngine

공개 클래스 FleetEngine Object
를 확장합니다.

Google Fleet Engine의 클라이언트입니다.

이 클래스를 사용하면 호출자가 enable 및 disableLocationTracking() 위치 추적을 사용 중지할 수 있습니다. 업데이트 빈도는 setLocationReportingInterval(long, TimeUnit)로 제어할 수 있습니다.

이 클래스는 스레드로부터 안전하지 않습니다.

중첩된 클래스 요약

인터페이스	FleetEngine.AuthTokenFactory		이 인터페이스의 인스턴스에는 다양한 작업이 실행될 때 승인 토큰을 제공하라는 메시지가 표시됩니다.
클래스	FleetEngine.ErrorListener		Fleet Engine 클라이언트는 이 인터페이스의 인스턴스를 사용하여 중요한 예외가 발생할 때 개발자에게 알립니다.
인터페이스	FleetEngine.FleetEngineConfig		이 인터페이스는 지원 중단되었습니다. 레거시 후크
인터페이스	FleetEngine.StatusListener		상태 업데이트 리스너입니다.
enum	FleetEngine.VehicleState		차량에 새로운 이동을 수락하는지 여부를 나타냅니다.

공개 메서드 요약

정적 void	clearInstance() clearInstance는 위치 추적을 중지하고 내부 상태를 삭제하며 FleetEngine 싱글톤을 null로 재설정합니다.
정적 void	createInstance(애플리케이션 애플리케이션, String providerId, String mobileId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener) Google Fleet Engine 서비스에 액세스하는 데 사용할 수 있는 FleetEngine 싱글톤을 만듭니다.
정적 void	createInstance(애플리케이션 애플리케이션, String providerId, String destinationId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) Google Fleet Engine 서비스에 액세스하는 데 사용할 수 있는 FleetEngine 싱글톤을 만듭니다.
void	disableLocationTracking() 위치 추적을 중지합니다.
void	enableLocationTracking() Fleet Engine 백엔드에 위치 보고서 업로드를 시작합니다.
정적 FleetEngine	getInstance() FleetEngine 싱글톤을 반환합니다.
long	getLocationReportingIntervalMs() 현재 위치 보고 간격(밀리초)을 반환합니다.
boolean	isLocationTrackingEnabled() 위치 추적의 사용 설정 여부를 반환합니다.
정적 void	setFleetEngineConfig(FleetEngine.FleetEngineConfig 구성)
void	setLocationReportingInterval(긴 간격, TimeUnit 간격 단위) 위치 보고서가 Fleet Engine 백엔드로 전송되는 최소 간격을 설정합니다.
정적 void	setNavigator(Navigator Navigator)
void	setVehicleState(FleetEngine.VehicleState 상태) VehicleState를 설정합니다.

상속받은 메서드 요약

java.lang.Object 클래스에서 상속됨

boolean	equals(객체 arg0)
최종 클래스<?>	getClass()
int	hashCode()
최종 void	notify()
최종 void	notifyAll()
문자열	toString()
최종 void	wait(long arg0, int arg1)
최종 void	wait(long arg0)
최종 void	wait()

공개 메서드

public static void clearInstance ()

clearInstance는 위치 추적을 중지하고 내부 상태를 삭제하며 FleetEngine 싱글톤을 null로 재설정합니다.

public static void createInstance (애플리케이션 애플리케이션, String providerId, String destinationId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

Google Fleet Engine 서비스에 액세스하는 데 사용할 수 있는 FleetEngine 싱글톤을 만듭니다. 내부적으로 이 메서드는 getRoadSnappedLocationProvider(Application)를 사용하여 RoadSnappedLocationProvider를 가져오므로 이 메서드를 호출하기 전에 Navigator를 성공적으로 가져와야 합니다. 그러지 않으면 IllegalStateException이 발생합니다. createInstance()를 두 번 호출하면 IllegalStateException이 발생합니다.

매개변수

방법	현재 Application, null이 아니어야 합니다.
providerId	제공업체의 ID
vehicleId	Fleet Engine에 연결될 차량의 ID입니다.
authTokenFactory	Fleet Engine 승인 토큰을 제공하는 factory
errorListener	Fleet Engine 클라이언트 오류가 발생할 때 알림을 받을 listener

생성 값

IllegalStateException	AndroidManifest.xml에 제공업체 ID가 지정되지 않은 경우

public static void createInstance (Application application, String providerId, String destinationId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

Google Fleet Engine 서비스에 액세스하는 데 사용할 수 있는 FleetEngine 싱글톤을 만듭니다. 내부적으로 이 메서드는 getRoadSnappedLocationProvider(Application)를 사용하여 RoadSnappedLocationProvider를 가져오므로 이 메서드를 호출하기 전에 Navigator를 성공적으로 가져와야 합니다. 그러지 않으면 IllegalStateException이 발생합니다. createInstance()를 두 번 호출하면 IllegalStateException이 발생합니다.

매개변수

방법	현재 Application이며 null이 아니어야 합니다.
providerId	제공업체의 ID입니다.
vehicleId	Fleet Engine에 연결될 차량의 ID입니다.
authTokenFactory	Fleet Engine 승인 토큰을 제공하는 factory입니다.
statusListener	상태 업데이트 리스너입니다.
errorListener	Fleet Engine 클라이언트 오류가 발생할 때 알림을 받을 listener입니다.

생성 값

IllegalStateException	제공업체 ID가 AndroidManifest.xml에 지정되지 않은 경우입니다.

공개 void disableLocationTracking ()

위치 추적을 중지합니다. 이미 진행 중인 보고서는 중지되지 않지만 새로운 게재순위 보고서가 생성되거나 전송되지 않습니다.

중지 후 enableLocationTracking()를 다시 호출하여 추적을 재개할 수 있습니다.

생성 값

IllegalStateException	위치 추적이 이미 중지된 경우

공개 void enableLocationTracking ()

Fleet Engine 백엔드에 위치 보고서 업로드를 시작합니다. 보고서는 주기적으로(기본적으로 5초마다) 생성됩니다. 네트워크 연결 끊김과 같은 일시적인 문제로 인해 보고서가 전송되지 않는 경우 보고 빈도가 줄어들 수 있습니다.

게재순위 보고서가 백그라운드 스레드에서 생성되고 이 호출은 즉시 반환됩니다.

disableLocationTracking()를 호출하여 위치 추적을 사용 중지할 수 있습니다.

보고 간격은 setLocationReportingInterval(long, TimeUnit)을 사용하여 변경할 수 있습니다.

생성 값

IllegalStateException	위치 추적이 이미 사용 설정된 경우

공개 정적 FleetEngine getInstance ()

FleetEngine 싱글톤을 반환합니다. getInstance() 전에 createInstance()를 호출해야 합니다. 그렇지 않으면 null이 반환됩니다.

공개 long getLocationReportingIntervalMs ()

현재 위치 보고 간격(밀리초)을 반환합니다.

공개 불리언 isLocationTrackingEnabled ()

위치 추적의 사용 설정 여부를 반환합니다.

public static void setFleetEngineConfig (FleetEngine.FleetEngineConfig config)

매개변수

config

공개 void setLocationReportingInterval (긴 간격, TimeUnit 간격 단위)

위치 보고서가 Fleet Engine 백엔드로 전송되는 최소 간격을 설정합니다. 기본 보고 간격은 10초입니다. 지원되는 최소 업데이트 간격은 5초입니다. 업데이트를 자주 하면 요청 및 오류가 느려질 수 있습니다.

매개변수

interval
intervalUnits

공개 정적 void setNavigator (Navigator Navigator)

매개변수

네비게이터

public void setVehicleState (FleetEngine.VehicleState 상태)

VehicleState를 설정합니다. 위치 업데이트가 사용 설정되면 다음 위치 업데이트 시 값이 전파됩니다. 위치 업데이트를 사용 중지하면 업데이트가 즉시 실행됩니다.

VehicleState 업데이트는 백그라운드 스레드에서 실행됩니다. 이 호출은 즉시 반환됩니다.

매개변수

state

생성 값

IllegalStateException	위치 추적이 아직 사용 설정되지 않은 경우 VehicleState가 온라인으로 설정된 경우입니다.