CloudSpatialAnchorSession クラス
- java.
lang. Object - java.
lang. AutoCloseable - com.
microsoft. azure. spatialanchors. CloudSpatialAnchorSession
- com.
- java.
public class CloudSpatialAnchorSession
このクラスを使用して、空間アンカーを作成、検索、および管理します。
コンストラクターの概要
コンストラクター | 説明 |
---|---|
CloudSpatialAnchorSession() |
既定の構成で新しいインスタンスを初期化します。 |
メソッドの概要
修飾子と型 | メソッドと説明 |
---|---|
void |
addAnchorLocatedListener(AnchorLocatedListener listener)
AnchorLocated イベントを受信するように、指定したリスナーを追加します。 アンカーの位置が決定されたときに発生します。 |
void |
addErrorListener(SessionErrorListener listener)
Error イベントを受信するように、指定したリスナーを追加します。 セッションが処理を続行できない場合に発生します。 |
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 を使用して空間アンカーを作成できません。 アンカーのスケール処理は、アプリ レベルで行う必要があります。 |
Cloud |
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<Cloud |
getActiveWatchers()
アクティブなウォッチャーの一覧を取得します。 |
Future<Cloud |
getAnchorPropertiesAsync(final String identifier)
特定の識別子がまだ見つからない場合でも、特定の識別子のクラウド空間アンカーを取得します。 |
Session |
getConfiguration()
セッションの構成情報を取得します。 構成設定は、セッションの開始時に有効になります。 |
Cloud |
getDiagnostics()
セッションの診断設定を取得します。これは、トラブルシューティングと改善のためにデータを収集して送信するために使用できます。 |
Platform |
getLocationProvider()
[粗い再割り当て](https://aka.ms/CoarseRelocalization) を使用してアンカーを作成および検索するために使用される場所プロバイダー。 |
Session |
getLogLevel()
セッション ログ イベントのログ レベル。 |
Future<List<String>> |
getNearbyAnchorIdsAsync(final NearDeviceCriteria criteria)
特定の条件に対応するすべての近くのクラウド空間アンカー ID の一覧を取得します。 |
Session |
getSession()
アンカーの検索に使用される追跡セッションを取得します。 このプロパティは、HoloLens プラットフォームでは使用できません。 |
String |
getSessionId()
セッションの一意の識別子を取得します。 |
Future<Session |
getSessionStatusAsync()
セッションの状態を記述する オブジェクトを取得します。 |
boolean | getTelemetryEnabled() |
void |
processFrame(Frame frame)
アプリケーションでは、フレームごとの処理が必要なプラットフォームでこのメソッドを呼び出す必要があります。 このメソッドは、HoloLens プラットフォームでは使用できません。 |
Future |
refreshAnchorPropertiesAsync(final CloudSpatialAnchor anchor)
指定した空間アンカーのプロパティを更新します。 |
void |
removeAnchorLocatedListener(AnchorLocatedListener listener)
AnchorLocated イベントを受信する指定したリスナーを削除します。 アンカーの位置が決定されたときに発生します。 |
void |
removeErrorListener(SessionErrorListener listener)
Error イベントを受信する指定したリスナーを削除します。 セッションが処理を続行できない場合に発生します。 |
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:
addErrorListener
public void addErrorListener(SessionErrorListener listener)
Error イベントを受信するように、指定したリスナーを追加します。 セッションが処理を続行できない場合に発生します。
Parameters:
addLocateAnchorsCompletedListener
public void addLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener)
LocateAnchorsCompleted イベントを受け取る指定したリスナーを追加します。 アンカーを検索しているウォッチャーのすべての結果が処理されるときに発生します。
Parameters:
addOnLogDebugListener
public void addOnLogDebugListener(OnLogDebugListener listener)
OnLogDebug イベントを受け取る指定したリスナーを追加します。 デバッグ ログ メッセージが生成されたときに発生します。
Parameters:
addSessionUpdatedListener
public void addSessionUpdatedListener(SessionUpdatedListener listener)
SessionUpdated イベントを受信するように指定されたリスナーを追加します。 すべてのセッション状態が更新されたときに発生します。
Parameters:
addTokenRequiredListener
public void addTokenRequiredListener(TokenRequiredListener listener)
TokenRequired イベントを受信するように、指定されたリスナーを追加します。 セッションに更新されたアクセス トークンまたは認証トークンが必要な場合に発生します。
Parameters:
addUpdatedSensorFingerprintRequiredListener
public void addUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener)
UpdatedSensorFingerprintRequired イベントを受信するように、指定したリスナーを追加します。 セッションがアプリケーションに更新されたセンサー フィンガープリントを要求したときに発生します。
Parameters:
close
public void close()
このリソースを閉じます。
createAnchorAsync
public Future createAnchorAsync(final CloudSpatialAnchor anchor)
指定したローカル アンカーおよび文字列プロパティから、新しい永続化された空間アンカーを作成します。 このメソッドに渡されるローカル アンカーには、有効な変換が必要です。 iOS などの Azure Spatial Anchors でサポートされている一部のプラットフォームでは、スケール コンポーネント != 1.0 を使用した変換が許可されていることに注意してください。 Azure Spatial Anchors SDK はこのような変換をサポートしていないため、エラー コード InvalidAnchorTransformRigidity を使用して空間アンカーを作成できません。 アンカーのスケール処理は、アプリ レベルで行う必要があります。
Parameters:
createWatcher
public CloudSpatialAnchorWatcher createWatcher(AnchorLocateCriteria criteria)
指定した条件を満たすアンカーを監視する新しいオブジェクトを作成します。
Parameters:
deleteAnchorAsync
public Future deleteAnchorAsync(final CloudSpatialAnchor anchor)
永続化された空間アンカーを削除します。
Parameters:
finalize
protected void finalize()
オブジェクトへの参照がなくなったとガベージ コレクションが判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。
getAccessTokenWithAccountKeyAsync
public Future
アカウント キーから Azure Spatial Anchors アクセス トークンを取得します。
Parameters:
getAccessTokenWithAuthenticationTokenAsync
public Future
認証トークンから Azure Spatial Anchors アクセス トークンを取得します。
Parameters:
getActiveWatchers
public List
アクティブなウォッチャーの一覧を取得します。
getAnchorPropertiesAsync
public Future
特定の識別子がまだ見つからない場合でも、特定の識別子のクラウド空間アンカーを取得します。
Parameters:
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:
getSession
public Session getSession()
アンカーの検索に使用される追跡セッションを取得します。 このプロパティは、HoloLens プラットフォームでは使用できません。
getSessionId
public String getSessionId()
セッションの一意の識別子を取得します。
getSessionStatusAsync
public Future
セッションの状態を記述する オブジェクトを取得します。
getTelemetryEnabled
public boolean getTelemetryEnabled()
processFrame
public void processFrame(Frame frame)
アプリケーションでは、フレームごとの処理が必要なプラットフォームでこのメソッドを呼び出す必要があります。 このメソッドは、HoloLens プラットフォームでは使用できません。
Parameters:
refreshAnchorPropertiesAsync
public Future refreshAnchorPropertiesAsync(final CloudSpatialAnchor anchor)
指定した空間アンカーのプロパティを更新します。
Parameters:
removeAnchorLocatedListener
public void removeAnchorLocatedListener(AnchorLocatedListener listener)
AnchorLocated イベントを受信する指定したリスナーを削除します。 アンカーの位置が決定されたときに発生します。
Parameters:
removeErrorListener
public void removeErrorListener(SessionErrorListener listener)
Error イベントを受信する指定したリスナーを削除します。 セッションが処理を続行できない場合に発生します。
Parameters:
removeLocateAnchorsCompletedListener
public void removeLocateAnchorsCompletedListener(LocateAnchorsCompletedListener listener)
LocateAnchorsCompleted イベントを受信する指定したリスナーを削除します。 アンカーを検索しているウォッチャーのすべての結果が処理されるときに発生します。
Parameters:
removeOnLogDebugListener
public void removeOnLogDebugListener(OnLogDebugListener listener)
OnLogDebug イベントを受信する指定したリスナーを削除します。 デバッグ ログ メッセージが生成されたときに発生します。
Parameters:
removeSessionUpdatedListener
public void removeSessionUpdatedListener(SessionUpdatedListener listener)
SessionUpdated イベントを受信する指定したリスナーを削除します。 すべてのセッション状態が更新されたときに発生します。
Parameters:
removeTokenRequiredListener
public void removeTokenRequiredListener(TokenRequiredListener listener)
TokenRequired イベントを受信する指定したリスナーを削除します。 セッションに更新されたアクセス トークンまたは認証トークンが必要な場合に発生します。
Parameters:
removeUpdatedSensorFingerprintRequiredListener
public void removeUpdatedSensorFingerprintRequiredListener(UpdatedSensorFingerprintRequiredListener listener)
UpdatedSensorFingerprintRequired イベントを受信する指定されたリスナーを削除します。 セッションがアプリケーションに更新されたセンサー フィンガープリントを要求したときに発生します。
Parameters:
reset
public void reset()
このセッションでキャプチャされた環境データをリセットします。追跡が失われた場合、アプリケーションはこのメソッドを呼び出す必要があります。 どのプラットフォームでも、 メソッドを呼び出すと、すべての内部キャッシュ状態が消去されます。
setLocationProvider
public void setLocationProvider(PlatformLocationProvider value)
[粗い再割り当て](https://aka.ms/CoarseRelocalization) を使用してアンカーを作成および検索するために使用される場所プロバイダー。
Parameters:
setLogLevel
public void setLogLevel(SessionLogLevel value)
セッション ログ イベントのログ レベル。
Parameters:
setSession
public void setSession(Session value)
アンカーの検索に使用する追跡セッションを設定します。 このプロパティは、HoloLens プラットフォームでは使用できません。
Parameters:
setTelemetryEnabled
public void setTelemetryEnabled(boolean value)
Parameters:
start
public void start()
セッションの環境データのキャプチャを開始します。
stop
public void stop()
セッションの環境データのキャプチャを停止し、未処理の検索操作をすべて取り消します。 環境データは維持されます。
updateAnchorPropertiesAsync
public Future updateAnchorPropertiesAsync(final CloudSpatialAnchor anchor)
指定した空間アンカーを更新します。
Parameters: