를 확장합니다.
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 | |
void |
setLocationReportingInterval(긴 간격, TimeUnit 간격 단위)
위치 보고서가 Fleet Engine 백엔드로 전송되는 최소 간격을 설정합니다.
|
정적 void |
setNavigator(Navigator Navigator)
|
void |
상속받은 메서드 요약
공개 메서드
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 ()
위치 추적의 사용 설정 여부를 반환합니다.
공개 void setLocationReportingInterval (긴 간격, TimeUnit 간격 단위)
위치 보고서가 Fleet Engine 백엔드로 전송되는 최소 간격을 설정합니다. 기본 보고 간격은 10초입니다. 지원되는 최소 업데이트 간격은 5초입니다. 업데이트를 자주 하면 요청 및 오류가 느려질 수 있습니다.
매개변수
interval | |
---|---|
intervalUnits |
public void setVehicleState (FleetEngine.VehicleState 상태)
VehicleState를 설정합니다. 위치 업데이트가 사용 설정되면 다음 위치 업데이트 시 값이 전파됩니다. 위치 업데이트를 사용 중지하면 업데이트가 즉시 실행됩니다.
VehicleState 업데이트는 백그라운드 스레드에서 실행됩니다. 이 호출은 즉시 반환됩니다.
매개변수
state |
---|
생성 값
IllegalStateException | 위치 추적이 아직 사용 설정되지 않은 경우 VehicleState가 온라인으로 설정된 경우입니다. |
---|