CloudSpatialAnchorSession 클래스

패키지:

com.microsoft.azure.spatialanchors

• java.lang.Object
• • java.lang.AutoCloseable
  • • com.microsoft.azure.spatialanchors.CloudSpatialAnchorSession

public class CloudSpatialAnchorSession

이 클래스를 사용하여 공간 앵커를 만들고, 찾고, 관리합니다.

생성자 요약

생성자	Description
CloudSpatialAnchorSession()	기본 구성을 사용하여 새 인스턴스를 초기화합니다.

메서드 요약

한정자 및 형식	메서드 및 설명
void	addAnchorLocatedListener(AnchorLocatedListener listener) 지정된 수신기를 추가하여 AnchorLocated 이벤트를 받습니다. 앵커의 위치가 결정되면 발생합니다.
void	addErrorListener(SessionErrorListener listener) 지정된 수신기를 추가하여 오류 이벤트를 받습니다. 세션이 처리를 계속할 수 없을 때 발생합니다.
void	addLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener) 지정한 수신기를 추가하여 LocateAnchorsCompleted 이벤트를 받습니다. 앵커를 찾는 감시자의 모든 결과가 처리될 때 발생합니다.
void	addOnLogDebugListener(OnLogDebugListener listener) 지정된 수신기를 추가하여 OnLogDebug 이벤트를 받습니다. 디버그 로그 메시지가 생성될 때 발생합니다.
void	addSessionUpdatedListener(SessionUpdatedListener listener) 지정된 수신기를 추가하여 SessionUpdated 이벤트를 받습니다. 모든 세션 상태가 업데이트되면 발생합니다.
void	addTokenRequiredListener(TokenRequiredListener listener) TokenRequired 이벤트를 수신하도록 지정된 수신기를 추가합니다. 세션에 업데이트된 액세스 토큰 또는 인증 토큰이 필요할 때 발생합니다.
void	addUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener) UpdatedSensorFingerprintRequired 이벤트를 받을 지정된 수신기를 추가합니다. 세션이 애플리케이션에서 업데이트된 센서 지문을 요청할 때 발생합니다.
void	close() 이 리소스를 닫습니다.
Future	createAnchorAsync(final CloudSpatialAnchor anchor) 지정된 로컬 앵커 및 문자열 속성에서 지속형 공간 앵커를 새로 만듭니다. 이 메서드에 전달된 로컬 앵커에는 유효한 변환이 있어야 합니다. iOS와 같은 Azure Spatial Anchors에서 지원하는 일부 플랫폼은 확장 구성 요소 != 1.0을 사용하여 변환을 허용합니다. Azure Spatial Anchors SDK는 이러한 변환을 지원하지 않으며 오류 코드 InvalidAnchorTransformRigidity를 사용하여 공간 앵커를 만들지 못합니다. 앵커에 대한 모든 크기 조정 처리는 앱 수준에서 수행해야 합니다.
CloudSpatialAnchorWatcher	createWatcher(AnchorLocateCriteria criteria) 지정된 조건을 충족하는 앵커를 감시하는 새 개체를 만듭니다.
Future	deleteAnchorAsync(final CloudSpatialAnchor anchor) 지속형 공간 앵커를 삭제합니다.
void	finalize() 가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다.
Future<String>	getAccessTokenWithAccountKeyAsync(final String accountKey) 계정 키에서 Azure Spatial Anchors 액세스 토큰을 가져옵니다.
Future<String>	getAccessTokenWithAuthenticationTokenAsync(final String authenticationToken) 인증 토큰에서 Azure Spatial Anchors 액세스 토큰을 가져옵니다.
List<CloudSpatialAnchorWatcher>	getActiveWatchers() 활성 감시자 목록을 가져옵니다.
Future<CloudSpatialAnchor>	getAnchorPropertiesAsync(final String identifier) 지정된 식별자에 대한 클라우드 공간 앵커를 가져옵니다(아직 위치하지 않은 경우에도).
SessionConfiguration	getConfiguration() 세션에 대한 구성 정보를 가져옵니다. 구성 설정은 세션이 시작될 때 적용됩니다.
CloudSpatialAnchorSessionDiagnostics	getDiagnostics() 문제 해결 및 개선을 위해 데이터를 수집하고 제출하는 데 사용할 수 있는 세션에 대한 진단 설정을 가져옵니다.
PlatformLocationProvider	getLocationProvider() [거친 재로컬화](https://aka.ms/CoarseRelocalization)를 사용하여 앵커를 만들고 찾는 데 사용되는 위치 공급자입니다.
SessionLogLevel	getLogLevel() 세션 로그 이벤트에 대한 로깅 수준입니다.
Future<List<String>>	getNearbyAnchorIdsAsync(final NearDeviceCriteria criteria) 지정된 조건에 해당하는 모든 가까운 클라우드 공간 앵커 ID 목록을 가져옵니다.
Session	getSession() 앵커를 찾는 데 사용되는 추적 세션을 가져옵니다. 이 속성은 HoloLens 플랫폼에서 사용할 수 없습니다.
String	getSessionId() 세션의 고유 식별자를 가져옵니다.
Future<SessionStatus>	getSessionStatusAsync() 세션의 상태를 설명하는 개체를 가져옵니다.
boolean	getTelemetryEnabled()
void	processFrame(Frame frame) 애플리케이션은 프레임당 처리가 필요한 플랫폼에서 이 메서드를 호출해야 합니다. 이 메서드는 HoloLens 플랫폼에서 사용할 수 없습니다.
Future	refreshAnchorPropertiesAsync(final CloudSpatialAnchor anchor) 지정된 공간 앵커의 속성을 새로 고칩니다.
void	removeAnchorLocatedListener(AnchorLocatedListener listener) AnchorLocated 이벤트를 수신하도록 지정된 수신기를 제거합니다. 앵커의 위치가 결정되면 발생합니다.
void	removeErrorListener(SessionErrorListener listener) 지정된 수신기를 제거하여 오류 이벤트를 수신합니다. 세션이 처리를 계속할 수 없을 때 발생합니다.
void	removeLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener) LocateAnchorsCompleted 이벤트를 수신하도록 지정된 수신기를 제거합니다. 앵커를 찾는 감시자의 모든 결과가 처리될 때 발생합니다.
void	removeOnLogDebugListener(OnLogDebugListener listener) OnLogDebug 이벤트를 받을 지정된 수신기를 제거합니다. 디버그 로그 메시지가 생성될 때 발생합니다.
void	removeSessionUpdatedListener(SessionUpdatedListener listener) SessionUpdated 이벤트를 수신하도록 지정된 수신기를 제거합니다. 모든 세션 상태가 업데이트되면 발생합니다.
void	removeTokenRequiredListener(TokenRequiredListener listener) TokenRequired 이벤트를 받을 지정된 수신기를 제거합니다. 세션에 업데이트된 액세스 토큰 또는 인증 토큰이 필요할 때 발생합니다.
void	removeUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener) UpdatedSensorFingerprintRequired 이벤트를 받을 지정된 수신기를 제거합니다. 세션이 애플리케이션에서 업데이트된 센서 지문을 요청할 때 발생합니다.
void	reset() 이 세션에서 캡처된 환경 데이터를 다시 설정합니다. 추적이 손실되면 애플리케이션에서 이 메서드를 호출해야 합니다. 모든 플랫폼에서 메서드를 호출하면 내부 캐시된 모든 상태가 정리됩니다.
void	setLocationProvider(PlatformLocationProvider value) [거친 재로컬화](https://aka.ms/CoarseRelocalization)를 사용하여 앵커를 만들고 찾는 데 사용되는 위치 공급자입니다.
void	setLogLevel(SessionLogLevel value) 세션 로그 이벤트에 대한 로깅 수준입니다.
void	setSession(Session value) 앵커를 찾는 데 사용되는 추적 세션을 설정합니다. 이 속성은 HoloLens 플랫폼에서 사용할 수 없습니다.
void	setTelemetryEnabled(boolean value)
void	start() 세션에 대한 환경 데이터 캡처를 시작합니다.
void	stop() 세션에 대한 환경 데이터 캡처를 중지하고 미해결 찾기 작업을 취소합니다. 환경 데이터는 유지 관리됩니다.
Future	updateAnchorPropertiesAsync(final CloudSpatialAnchor anchor) 지정된 공간 앵커를 업데이트.

생성자 세부 정보

CloudSpatialAnchorSession

public CloudSpatialAnchorSession()

기본 구성을 사용하여 새 인스턴스를 초기화합니다.

메서드 세부 정보

addAnchorLocatedListener

public void addAnchorLocatedListener(AnchorLocatedListener listener)

지정된 수신기를 추가하여 AnchorLocated 이벤트를 받습니다. 앵커의 위치가 결정되면 발생합니다.

Parameters:

listener

addErrorListener

public void addErrorListener(SessionErrorListener listener)

지정된 수신기를 추가하여 오류 이벤트를 받습니다. 세션이 처리를 계속할 수 없을 때 발생합니다.

Parameters:

listener

addLocateAnchorsCompletedListener

public void addLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener)

지정한 수신기를 추가하여 LocateAnchorsCompleted 이벤트를 받습니다. 앵커를 찾는 감시자의 모든 결과가 처리될 때 발생합니다.

Parameters:

listener

addOnLogDebugListener

public void addOnLogDebugListener(OnLogDebugListener listener)

지정된 수신기를 추가하여 OnLogDebug 이벤트를 받습니다. 디버그 로그 메시지가 생성될 때 발생합니다.

Parameters:

listener

addSessionUpdatedListener

public void addSessionUpdatedListener(SessionUpdatedListener listener)

지정된 수신기를 추가하여 SessionUpdated 이벤트를 받습니다. 모든 세션 상태가 업데이트되면 발생합니다.

Parameters:

listener

addTokenRequiredListener

public void addTokenRequiredListener(TokenRequiredListener listener)

TokenRequired 이벤트를 수신하도록 지정된 수신기를 추가합니다. 세션에 업데이트된 액세스 토큰 또는 인증 토큰이 필요할 때 발생합니다.

Parameters:

listener

addUpdatedSensorFingerprintRequiredListener

public void addUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener)

UpdatedSensorFingerprintRequired 이벤트를 받을 지정된 수신기를 추가합니다. 세션이 애플리케이션에서 업데이트된 센서 지문을 요청할 때 발생합니다.

Parameters:

listener

close

public void close()

이 리소스를 닫습니다.

createAnchorAsync

public Future createAnchorAsync(final CloudSpatialAnchor anchor)

지정된 로컬 앵커 및 문자열 속성에서 지속형 공간 앵커를 새로 만듭니다. 이 메서드에 전달된 로컬 앵커에는 유효한 변환이 있어야 합니다. iOS와 같은 Azure Spatial Anchors에서 지원하는 일부 플랫폼은 확장 구성 요소 != 1.0을 사용하여 변환을 허용합니다. Azure Spatial Anchors SDK는 이러한 변환을 지원하지 않으며 오류 코드 InvalidAnchorTransformRigidity를 사용하여 공간 앵커를 만들지 못합니다. 앵커에 대한 모든 크기 조정 처리는 앱 수준에서 수행해야 합니다.

Parameters:

anchor - 지속할 앵커입니다.

createWatcher

public CloudSpatialAnchorWatcher createWatcher(AnchorLocateCriteria criteria)

지정된 조건을 충족하는 앵커를 감시하는 새 개체를 만듭니다.

Parameters:

criteria - 감시할 앵커에 대한 조건입니다.

deleteAnchorAsync

public Future deleteAnchorAsync(final CloudSpatialAnchor anchor)

지속형 공간 앵커를 삭제합니다.

Parameters:

anchor - 삭제할 앵커입니다.

finalize

protected void finalize()

가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다.

getAccessTokenWithAccountKeyAsync

public Future getAccessTokenWithAccountKeyAsync(final String accountKey)

계정 키에서 Azure Spatial Anchors 액세스 토큰을 가져옵니다.

Parameters:

accountKey - 계정 키.

getAccessTokenWithAuthenticationTokenAsync

public Future getAccessTokenWithAuthenticationTokenAsync(final String authenticationToken)

인증 토큰에서 Azure Spatial Anchors 액세스 토큰을 가져옵니다.

Parameters:

authenticationToken - 인증 토큰.

getActiveWatchers

public List getActiveWatchers()

활성 감시자 목록을 가져옵니다.

getAnchorPropertiesAsync

public Future getAnchorPropertiesAsync(final String identifier)

지정된 식별자에 대한 클라우드 공간 앵커를 가져옵니다(아직 위치하지 않은 경우에도).

Parameters:

identifier - 찾을 식별자입니다.

getConfiguration

public SessionConfiguration getConfiguration()

세션에 대한 구성 정보를 가져옵니다. 구성 설정은 세션이 시작될 때 적용됩니다.

getDiagnostics

public CloudSpatialAnchorSessionDiagnostics getDiagnostics()

문제 해결 및 개선을 위해 데이터를 수집하고 제출하는 데 사용할 수 있는 세션에 대한 진단 설정을 가져옵니다.

getLocationProvider

public PlatformLocationProvider getLocationProvider()

[거친 재로컬화](https://aka.ms/CoarseRelocalization)를 사용하여 앵커를 만들고 찾는 데 사용되는 위치 공급자입니다.

getLogLevel

public SessionLogLevel getLogLevel()

세션 로그 이벤트에 대한 로깅 수준입니다.

getNearbyAnchorIdsAsync

public Future> getNearbyAnchorIdsAsync(final NearDeviceCriteria criteria)

지정된 조건에 해당하는 모든 가까운 클라우드 공간 앵커 ID 목록을 가져옵니다.

Parameters:

criteria - 검색 조건입니다.

getSession

public Session getSession()

앵커를 찾는 데 사용되는 추적 세션을 가져옵니다. 이 속성은 HoloLens 플랫폼에서 사용할 수 없습니다.

getSessionId

public String getSessionId()

세션의 고유 식별자를 가져옵니다.

getSessionStatusAsync

public Future getSessionStatusAsync()

세션의 상태를 설명하는 개체를 가져옵니다.

getTelemetryEnabled

public boolean getTelemetryEnabled()

processFrame

public void processFrame(Frame frame)

애플리케이션은 프레임당 처리가 필요한 플랫폼에서 이 메서드를 호출해야 합니다. 이 메서드는 HoloLens 플랫폼에서 사용할 수 없습니다.

Parameters:

frame - 처리할 AR 프레임입니다.

refreshAnchorPropertiesAsync

public Future refreshAnchorPropertiesAsync(final CloudSpatialAnchor anchor)

지정된 공간 앵커의 속성을 새로 고칩니다.

Parameters:

anchor - 새로 고칠 앵커입니다.

removeAnchorLocatedListener

public void removeAnchorLocatedListener(AnchorLocatedListener listener)

AnchorLocated 이벤트를 수신하도록 지정된 수신기를 제거합니다. 앵커의 위치가 결정되면 발생합니다.

Parameters:

listener

removeErrorListener

public void removeErrorListener(SessionErrorListener listener)

지정된 수신기를 제거하여 오류 이벤트를 수신합니다. 세션이 처리를 계속할 수 없을 때 발생합니다.

Parameters:

listener

removeLocateAnchorsCompletedListener

public void removeLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener)

LocateAnchorsCompleted 이벤트를 수신하도록 지정된 수신기를 제거합니다. 앵커를 찾는 감시자의 모든 결과가 처리될 때 발생합니다.

Parameters:

listener

removeOnLogDebugListener

public void removeOnLogDebugListener(OnLogDebugListener listener)

OnLogDebug 이벤트를 받을 지정된 수신기를 제거합니다. 디버그 로그 메시지가 생성될 때 발생합니다.

Parameters:

listener

removeSessionUpdatedListener

public void removeSessionUpdatedListener(SessionUpdatedListener listener)

SessionUpdated 이벤트를 수신하도록 지정된 수신기를 제거합니다. 모든 세션 상태가 업데이트되면 발생합니다.

Parameters:

listener

removeTokenRequiredListener

public void removeTokenRequiredListener(TokenRequiredListener listener)

TokenRequired 이벤트를 받을 지정된 수신기를 제거합니다. 세션에 업데이트된 액세스 토큰 또는 인증 토큰이 필요할 때 발생합니다.

Parameters:

listener

removeUpdatedSensorFingerprintRequiredListener

public void removeUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener)

UpdatedSensorFingerprintRequired 이벤트를 받을 지정된 수신기를 제거합니다. 세션이 애플리케이션에서 업데이트된 센서 지문을 요청할 때 발생합니다.

Parameters:

listener

reset

public void reset()

이 세션에서 캡처된 환경 데이터를 다시 설정합니다. 추적이 손실되면 애플리케이션에서 이 메서드를 호출해야 합니다. 모든 플랫폼에서 메서드를 호출하면 내부 캐시된 모든 상태가 정리됩니다.

setLocationProvider

public void setLocationProvider(PlatformLocationProvider value)

[거친 재로컬화](https://aka.ms/CoarseRelocalization)를 사용하여 앵커를 만들고 찾는 데 사용되는 위치 공급자입니다.

Parameters:

value - 새 값입니다.

setLogLevel

public void setLogLevel(SessionLogLevel value)

세션 로그 이벤트에 대한 로깅 수준입니다.

Parameters:

value - 새 값입니다.

setSession

public void setSession(Session value)

앵커를 찾는 데 사용되는 추적 세션을 설정합니다. 이 속성은 HoloLens 플랫폼에서 사용할 수 없습니다.

Parameters:

value - 새 값입니다.

setTelemetryEnabled

public void setTelemetryEnabled(boolean value)

Parameters:

value

start

public void start()

세션에 대한 환경 데이터 캡처를 시작합니다.

stop

public void stop()

세션에 대한 환경 데이터 캡처를 중지하고 미해결 찾기 작업을 취소합니다. 환경 데이터는 유지 관리됩니다.

updateAnchorPropertiesAsync

public Future updateAnchorPropertiesAsync(final CloudSpatialAnchor anchor)

지정된 공간 앵커를 업데이트.

Parameters:

anchor - 업데이트할 앵커입니다.