L'SDK Sceneform per Android è stato open source e archiviato (github.com/google-ar/sceneform-android-sdk) con la versione 1.16.0.
Questo sito (developers.google.com/sceneform) funge da archivio di documentazione per la versione precedente, Sceneform SDK for Android 1.15.0.
Non utilizzare la versione 1.17.0 degli elementi Maven di Sceneform.
È possibile utilizzare gli artefatti 1.17.1 Maven. A parte la versione, tuttavia, gli artefatti 1.17.1 sono identici agli artefatti 1.15.0.

Questa pagina è stata tradotta dall'API Cloud Translation.

Frammento di base

classe astratta pubblica BaseArFragment

Sottoclassi dirette note

Frammento

Il frammento AR introduce il layout della vista richiesto e i controller per le funzionalità AR comuni.

Corsi nidificati

interfaccia	BaseArFragment.OnSessionInitializationListener		Richiamato quando la sessione ARCore viene inizializzata.
interfaccia	BaseArFragment.OnTapArPlaneListener		Richiamato quando viene toccato un aereo ARCore.

Costruttori pubblici

BaseArFragment()

Metodi pubblici

astratto String[]	getAdditionalPermissions() Restituisce una serie di autorizzazioni pericolose necessarie per l'app, oltre a Manifest.permission.CAMERA, necessaria da ARCore.
Visualizzazione panoramica	getArSceneView() Visualizza l'ArSceneView per questo frammento.
PlaneDiscoveryController	getPlaneDiscoveryController() Recupera il controller di rilevamento degli aerei, che mostra le istruzioni su come cercare gli aerei.
Sistema di trasformazione	getTransformationSystem() Recupera il sistema di trasformazione, che viene utilizzato da `TransformableNode` per rilevare i gesti e coordinare il nodo selezionato.
booleano astratto	isArRequired() Restituisce true se l'applicazione è AR richiesta. false se AR facoltativo.
View (Visualizzazione)	onCreateView(gonfiatore LayoutInflater, container ViewGroup, Bundle savedInstanceState)
nullo	onDestroy()
nullo	onDestroyView()
nullo	onpause()
nullo	onPeekTouch(HitTestResult hitTestResult, MotionEvent motionEvent) Chiamata quando un evento touch viene inviato a una scena.
nullo	onRequestPermissionsResult(int requestCode, String[] permissions, int[] risultati) Riceve i risultati per le richieste di autorizzazione.
nullo	onRiprendi()
nullo	onUpdate(FrameTime frameTime) Chiamata una volta per frame subito prima dell'aggiornamento della scena.
nullo	setOnSessionInitializationListener(BaseArFragment.OnSessionInitializationListener onSessionInitializationListener) Registra un callback da richiamare quando viene avviata la sessione ARCore.
nullo	setOnTapArPlaneListener(BaseArFragment.OnTapArPlaneListener onTapArPlaneListener) Registra un callback da richiamare quando viene toccato un piano ARCore.

Metodi protetti

Booleano	getCanRequestSensitivePermission() Se true, `requestDangerousPermissions()` restituisce senza eseguire alcuna azione, se verranno richieste autorizzazioni false
Config astratta	getSessionConfiguration(session sessione)
astratta Set<Session.Feature>	getSessionfeatures() Specifica funzionalità aggiuntive per la creazione di un elemento `Session` ARCore.
astratto void	handleSessionException(ExceptionException sessionException)
finale null	InitializeSession() Inizializza la sessione ARCore.
Sistema di trasformazione	makeTransformationSystem(). Crea il sistema di trasformazione utilizzato da questo frammento.
nullo	onWindowFocusChanged(booleano focus)
nullo	requestSensitivePermissions() Avvia il processo di richiesta di autorizzazioni pericolose.
booleano finale	requestInstall()
nullo	setCanRequestPotentialPermissions(Boolean canRequestSensitivePermissions) Se true, `requestDangerousPermissions()` restituisce senza eseguire alcuna azione, se verranno richieste autorizzazioni false
nullo	setupSelectionRenderable(FootprintSelectionvisualizer selectVisualizzaizer)

Metodi ereditati

Dalla classe android.support.v4.app.Fragment

nullo	dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)
booleano finale	uguale a (Oggetto arg0)
attività finale	getActivity()
boolean	getAllowEnterTransitionoverlay()
boolean	getAllowReturnTransitionoverlay()
finale Set	getArguments()
finale FragmentManager	getChildFragmentManager()
Contesto	getContext()
ViewModelProvider.Factory	getDefaultViewModelProviderFactory()
Oggetto	getEnterTransition()
Oggetto	getExitTransition()
finale FragmentManager	getFragmentManager()
finale Oggetto	getHost()
int finale	getId()
Layout interno	getLayoutInflater(Pacchetto arg0)
finale LayoutInflater	getLayoutInflater()
Ciclo di vita	getLifecycle()
GestoreGestore	getLoadManager()
finale Frammento	getParentFragment()
finale FragmentManager	getParentFragmentManager()
Oggetto	getReenterTransition()
finale Risorse	getResources()
booleano finale	getConservaInstance
Oggetto	getReturnTransition()
finale SaveStateRegistry	getSavedStateRegistry()
Oggetto	getSharedElementEnterTransition()
Oggetto	getSharedElementReturnTransition()
finale Stringa	getString(int arg0, Oggetto... arg1)
finale Stringa	getString(int arg0)
finale Stringa	getTag()
finale Frammento	getTargetFragment()
int finale	getTargetRequestCode()
finale CharSequenza	getText(int arg0)
boolean	getUserVisibleHint()
View (Visualizzazione)	getView()
Proprietario del ciclo di vita	getViewLifecycleOwner()
LiveData<LifecycleOwner>	getViewLifecycleOwnerLiveData()
Visualizza il negozio di modelli	getViewModelStore()
booleano finale	hasOptionsMenu()
int finale	hashCode()
Frammento statico	instainate (Contesto arg0, String arg1)
Frammento statico	instainate (Contesto arg0, String arg1, Set arg2)
booleano finale	èaggiunto()
booleano finale	isDetatch()
booleano finale	isHidden()
booleano finale	isInLayout()
booleano finale	isMenuVisible()
booleano finale	isRemoving()
booleano finale	isRiprendi()
booleano finale	isStateSaved()
booleano finale	isVisible()
nullo	onActivityCreated(Set arg0)
nullo	onActivityResult(int arg0, int arg1, intent arg2)
nullo	onAttach(Attività)
nullo	onAttach(Contesto arg0)
nullo	onAttachFragment(Frammento arg0)
nullo	onConfigurationChanged(Configurazione arg0)
boolean	onContextItemSelected (MenuItem argomento)
nullo	onCreate(Set arg0)
Animazione	onCreateAnimation(int arg0, boolean arg1, int arg2)
Animatore	onCreateAnimator(int arg0, boolean arg1, int arg2)
nullo	onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)
nullo	onCreateOptionsMenu(Menu arg0, MenuInflater arg1)
View (Visualizzazione)	onCreateView(LayoutInflater arg0, ViewGroup arg1 e Bundle arg2)
nullo	onDestroy()
nullo	onDestroyOptionsMenu()
nullo	onDestroyView()
nullo	onDetach()
Layout interno	onGetLayoutInflater(set arg0)
nullo	onHiddenChanged(arg0 booleano)
nullo	onInflate(Attività arg0, AttributeSet arg1, Bundle arg2)
nullo	onInflate(Contesto arg0, AttributeSet arg1, Bundle arg2)
nullo	onBassaMemoria()
nullo	onMultiWindowModeChanged(arg0 booleano)
boolean	onOptionsItemSelected(MenuItem argomento)
nullo	onOptionsMenuClosed(Menu arg0)
nullo	onpause()
nullo	onPictureInPictureModeChanged(arg0 booleano)
nullo	onPrepareOptionsMenu(Menu arg0)
nullo	onPrimaryNavigazioneFragmentChanged(arg0 booleano)
nullo	onRequestPermissionsResult(int arg0, string[] arg1, int[] arg2)
nullo	onRiprendi()
nullo	onSaveInstanceState(Set arg0)
nullo	onStart()
nullo	onStop()
nullo	onViewCreated(Visualizza arg0, Set arg1)
nullo	onViewStateRestored(Set arg0)
nullo	postponeEnterTransition()
finale null	postponeEnterTransition(long arg0, TimeUnit arg1)
nullo	registerForContextMenu (visualizzazione arg0)
finale null	requestPermissions(String[] arg0, int arg1)
attività finale	requireActivity()
finale Set	requireArguments()
finale Contesto	requireContext()
finale FragmentManager	requireFragmentManager()
finale Oggetto	requireHost()
finale Frammento	requireParentFragment()
finale Visualizza	requireView()
nullo	setAllowEnterTransitionoverlay(arg0 booleano)
nullo	setAllowReturnTransitionOverlay(arg0 booleano)
nullo	setArguments(Set arg0)
nullo	setEnterSharedElementCallback(SharedElementCallback arg0)
nullo	setEnterTransition(Oggetto arg0)
nullo	setExitSharedElementCallback(SharedElementCallback arg0)
nullo	setExitTransition (oggetto arg0)
nullo	setHasOptionsMenu(boolean arg0)
nullo	setInitialSavedState(Frammento.SavedState arg0)
nullo	setMenuVisibilità(arg0 booleano)
nullo	setReenterTransition (Oggetto arg0)
nullo	setserveInstance(arg0 booleano)
nullo	setReturnTransition(Oggetto arg0)
nullo	setSharedElementEnterTransition (oggetto arg0)
nullo	setSharedElementReturnTransition(Oggetto arg0)
nullo	setTargetFragment(Frammento arg0, int arg1)
nullo	setUserVisibleHint(arg0 booleano)
boolean	shouldShowRequestPermissionRationale(Stringa argomento)
nullo	startActivity(Intent arg0)
nullo	startActivity(Intent arg0, Bundle arg1)
nullo	startActivityForResult(Intent arg0, int arg1)
nullo	startActivityForResult(Intent arg0, int arg1, Bundle arg2)
nullo	startIntentSenderForResult(IntentSender arg0, int arg1, Intent arg2, int arg3, int arg4, int arg5, Bundle arg6)
nullo	startPostponedEnterTransition()
Stringa	toString()
nullo	unregisterForContextMenu(Visualizzazione arg0)

Dalla classe java.lang.Object

Oggetto	clonare()
boolean	uguale a(Oggetto arg0)
nullo	finalizzare()
final Class<?>	getClass()
int	hashCode()
finale null	notifica()
finale null	notificationAll()
Stringa	toString()
finale null	wait(long arg0, int arg1)
finale null	wait(lungo arg0)
finale null	wait()

Dall'interfaccia android.content.ComponentCallbacks

astratto void	onConfigurationChanged(Configurazione arg0)
astratto void	onBassaMemoria()

Dall'interfaccia android.view.View.OnCreateContextMenuListener

astratto void

onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)

Dall'interfaccia android.arch.lifecycle.LifecycleOwner

ciclo di vita astratto

getLifecycle()

Dall'interfaccia android.arch.lifecycle.ViewModelStoreOwner

astratto ViewModelStore

getViewModelStore()

Dall'interfaccia android.arch.lifecycle.HasDefaultViewModelProviderFactory

astratto ViewModelProvider.Factory

getDefaultViewModelProviderFactory()

Dall'interfaccia androidx.savedstate.SavedStateRegistryOwner

astratto StateStateRegistry

getSavedStateRegistry()

Dall'interfaccia com.google.ar.sceneform.Scene.OnPeekTouchListener

astratto void

onPeekTouch(HitTestResult hitTestResult, MotionEvent motionEvent)

Chiamata quando un evento touch viene inviato a una scena.

Dall'interfaccia com.google.ar.sceneform.Scene.OnUpdateListener

astratto void

onUpdate(FrameTime frameTime)

Chiamata una volta per frame subito prima dell'aggiornamento della scena.

Costruttori pubblici

pubblica BaseArFragment ()

Metodi pubblici

pubblica astratto Stringa[] getAdditionalPermissions ()

Restituisce una serie di autorizzazioni pericolose necessarie per l'app, oltre a Manifest.permission.CAMERA, necessaria da ARCore. Se non sono necessarie autorizzazioni aggiuntive, deve essere restituito un array vuoto.

pubblico ArSceneView getArSceneView ()

Visualizza l'ArSceneView per questo frammento.

pubblica PlaneDiscoveryController getPlaneDiscoveryController ()

Recupera il controller di rilevamento degli aerei, che mostra le istruzioni su come cercare gli aerei.

pubblica TransformationSystem getTransformationSystem ()

Recupera il sistema di trasformazione, che viene utilizzato da TransformableNode per rilevare i gesti e coordinare il nodo selezionato.

pubblica astratto booleano isArRequired ()

Restituisce true se l'applicazione è AR richiesta. false se AR facoltativo. Viene chiamato durante l'inizializzazione dell'applicazione e della sessione.

pubblica Visualizza onCreateView (LayoutInflater gonfiatore, ViewGroup container, Bundle savedInstanceState)

Parametri

gonfiatore
container
savedInstanceState

pubblica void onDestroy ()

pubblica void onDestroyView ()

pubblica void onpause ()

public void onPeekTouch (HitTestResult hitTestResult, MotionEvent motionEvent)

Chiamata quando un evento touch viene inviato a una scena. Il callback verrà richiamato prima di richiamare Scene.OnTouchListener. Viene richiamato anche se il gesto è stato utilizzato, consentendo di osservare tutti gli eventi di movimento inviati nella scena. Viene chiamato anche se il tocco non è posizionato su un nodo, nel qual caso getNode() sarà null.

Parametri

HitTestResult	che rappresenta il nodo toccato
movimentoEvento	l'evento di movimento

public void onRequestPermissionsResult (int requestCode, String[] permissions, int[] risultati)

Riceve i risultati per le richieste di autorizzazione.

Apre una finestra di dialogo per richiedere le autorizzazioni. La finestra di dialogo può indirizzare l'utente all'app Impostazioni o completare l'attività.

Parametri

codiceCodice
autorizzazioni
risultati

pubblica void onRiprendi ()

pubblica void onUpdate (FrameTime frameTime)

Chiamata una volta per frame subito prima dell'aggiornamento della scena.

Parametri

frameTime	fornisce informazioni sull'ora per il frame corrente

public void setOnSessionInitializationListener (BaseArFragment.OnSessionInitializationListener onSessionInitializationListener)

Registra un callback da richiamare quando viene avviata la sessione ARCore. Il callback viene richiamato solo una volta dopo l'inizializzazione della sessione e prima del ripristino.

Parametri

onSessionInitializationListener	il `BaseArFragment.OnSessionInitializationListener` da allegare.

public void setOnTapArPlaneListener (BaseArFragment.OnTapArPlaneListener onTapArPlaneListener)

Registra un callback da richiamare quando viene toccato un piano ARCore. Il callback verrà richiamato solo se non è stato toccato alcun oggetto Node.

Parametri

onTapArPlaneListener	`BaseArFragment.OnTapArPlaneListener` da allegare

Metodi protetti

protetto booleano getCanRequestSensitivePermissions ()

Se true, requestDangerousPermissions() restituisce senza eseguire alcuna azione, se verranno richieste autorizzazioni false

Config. astratto protetto getSessionConfiguration (sessione)

Parametri

sessione

astratto protetto Set<Session.Feature> getSessionfeatures ()

Specifica funzionalità aggiuntive per la creazione di un elemento Session ARCore. Consulta Session.Feature.

astratto protetto void handleSessionException (ExceptionException sessionException)

Parametri

Eccezione sessione

finale protetto null inizializza sessione ()

Inizializza la sessione ARCore. L'autorizzazione VIDEOCAMERA viene controllata prima di controllare lo stato dell'installazione di ARCore. Una volta che le autorizzazioni e l'installazione sono corrette, viene chiamato il metodo #getSessionConfiguration(Session sessione) per utilizzare la configurazione della sessione. Sceneform richiede l'aggiornamento della sessione ARCore tramite LATEST_CAMERA_IMAGE per evitare il blocco durante il disegno. Questa modalità è impostata sull'oggetto di configurazione restituito dalla sottoclasse.

protetto TransformationSystem makeTransformationSystem ()

Crea il sistema di trasformazione utilizzato da questo frammento. Può essere sostituito per creare un sistema di trasformazione personalizzato.

Protected void onWindowFocusChanged (boolean hasFocus)

Parametri

HasFocus

protetto void requestSensitivePermission ()

Avvia il processo di richiesta di autorizzazioni pericolose. Combina l'autorizzazione CAMERA richiesta per ARCore e qualsiasi autorizzazione restituita da getAdditionalPermissions(). Non è prevista alcuna elaborazione specifica sul risultato della richiesta, le sottoclassi possono sostituire onRequestPermissionsResult() se è necessaria un'ulteriore elaborazione.

setCanRequestDangerousPermissions(Boolean) può interrompere questa funzione.

booleano finale protetto requestInstall ()

Genera

Eccezione non disponibile

Protected void setCanRequestSensitivePermissions (Booleano canRequestSensitivePermissions)

Se true, requestDangerousPermissions() restituisce senza eseguire alcuna azione, se verranno richieste autorizzazioni false

Parametri

canRequestSensitivePermission

Protected void setupSelectionRenderable (FootprintSelection Visualizer selectVisualizzaizer)

Parametri

selezioneVisualizzatore