程序包 ohos.wearable.tile

类 TileAbility

java.lang.Object

ohos.app.AbilityContext

ohos.aafwk.ability.Ability

ohos.wearable.tile.TileAbility

public abstract class TileAbility
extends ohos.aafwk.ability.Ability

A base class for implementing a tile.

You need to implement onStatusChanged(ohos.wearable.tile.TileStatus) on a TileAbility object with the tile lifecycle state passed to return a TileEntity object as defined.

从以下版本开始:

4

嵌套类概要

从类继承的嵌套类/接口 ohos.aafwk.ability.Ability

ohos.aafwk.ability.Ability.LayoutParamsHelper, ohos.aafwk.ability.Ability.WindowAttributeHelper

字段概要

字段

限定符和类型	字段	说明
static java.lang.String	ACTION_REQUEST_UPDATE	Indicates the action declared for the child class of TileAbility to request an update.
static java.lang.String	ACTION_TILE	Indicates the action declared for the child class of TileAbility in the config.json file.
static java.lang.String	ACTION_TILE_DEFAULT	Indicates the action declared for the child class of TileAbility in the config.json file for a tile to be displayed in the visible tile list by default.
static java.lang.String	EXTRA_CLASS_NAME	Indicates the name of the child class of TileAbility.
static java.lang.String	EXTRA_PACKAGE_NAME	Indicates the package name of the child class of TileAbility.
static java.lang.String	EXTRA_TILE_IDS	Indicates the tile ID.

从类继承的字段 ohos.aafwk.ability.Ability

FORM_INVISIBLE, FORM_VISIBLE

从接口继承的字段 ohos.app.Context

CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESOUCE_ONLY, CONTEXT_RESTRICTED, MODE_APPEND, MODE_PRIVATE

构造器概要

构造器

构造器	说明
TileAbility()

方法概要

限定符和类型	方法	说明
boolean	isInRetailMode()	Checks whether the current system is in retail mode.
void	notifyDataChanged(ohos.app.Context context, ohos.bundle.ElementName elementName)	Notifies the system of tile data changes.
protected ohos.rpc.IRemoteObject	onConnect(ohos.aafwk.content.Intent intent)
protected void	onDisconnect(ohos.aafwk.content.Intent intent)
protected abstract TileEntity	onStatusChanged(TileStatus status)	Called when the tile state changes.

从类继承的方法 ohos.aafwk.ability.Ability

addActionRoute, batchInsert, call, cancelBackgroundRunning, connectAbility, continueAbility, continueAbility, continueAbilityReversibly, continueAbilityReversibly, createPipeFile, delete, denormalizeUri, disconnectAbility, dispatchAccessibilityEventInfo, executeBatch, executeOperation, findComponentById, getAbilityName, getAbilityPackage, getAdmissionTransitionConcurEnabled, getAdmissionTransitionObject, getAVController, getBackTransitionConcurEnabled, getBackTransitionObject, getContinuationRegisterManager, getContinuationState, getCurrentFocus, getFileTypes, getIntent, getLayoutParams, getLifecycle, getOriginalDeviceId, getQuitTransitionObject, getReadmissionTransitionObject, getSharedItemAdmissionTransitionObject, getSharedItemBackTransitionObject, getSharedItemQuitTransitionObject, getSharedItemReadmissionTransitionObject, getState, getType, getVolumeTypeAdjustedByKey, getWindow, hasWindowFocus, insert, isTemporary, isTerminating, keepBackgroundRunning, normalizeUri, onAbilityResult, onAcquireFormState, onActive, onBackground, onBackPressed, onCastTempForm, onCommand, onCommand, onConfigurationUpdated, onCreateForm, onCreateForm, onDeleteForm, onDeleteForm, onEventDispatch, onEventNotify, onForeground, onHotkeyTriggered, onInactive, onInitialized, onKeyDown, onKeyPressAndHold, onKeyUp, onLeaveForeground, onMemoryLevel, onMissionDeleted, onNewDescription, onNewIntent, onOrientationChanged, onPostActive, onPostStart, onReconnect, onRequestPermissionsFromUserResult, onRestoreAbilityState, onSaveAbilityState, onSetCaller, onStart, onStop, onStoreDataWhenConfigChange, onTopActiveAbilityChanged, onTouchEvent, onTriggerFormEvent, onTriggerFormEvent, onUnloadForm, onUpdateForm, onUpdateForm, onWindowFocusChanged, openFile, openRawFile, parsePredictionArgsReference, parseValuesBucketReference, postTask, query, reload, reverseContinueAbility, setAbilitySliceAnimator, setAdmissionTransitionConcurEnabled, setAdmissionTransitionObject, setAVController, setBackTransitionConcurEnabled, setBackTransitionObject, setFormNextRefreshTime, setIntent, setIsAmbientMode, setLayoutParams, setMainRoute, setQuitTransitionObject, setReadmissionTransitionObject, setResult, setSharedItemAdmissionTransitionObject, setSharedItemBackTransitionObject, setSharedItemQuitTransitionObject, setSharedItemReadmissionTransitionObject, setSwipeToDismiss, setUIContent, setUIContent, setVolumeTypeAdjustedByKey, setWindowBackgroundColor, shutdown, startAbility, startAbility, startAbility, startAbility, startAbilityForResult, startAbilityForResult, startAssistAbility, stopAbility, stopAssistAbility, supportHighPerformanceUI, terminateAbility, update, updateForm, updateForm, updateForm, updateForm

从类继承的方法 ohos.app.AbilityContext

attachBaseContext, canRequestPermission, compelVerifyCallerPermission, compelVerifyCallerUriPermission, compelVerifyPermission, compelVerifyPermission, compelVerifyUriPermission, compelVerifyUriPermission, compelVerifyUriPermission, createBundleContext, createParallelTaskDispatcher, createSerialTaskDispatcher, deleteFile, displayUnlockMissionMessage, getAbilityInfo, getAbilityManager, getAbilityPackageContext, getApplicationContext, getApplicationInfo, getAppType, getBundleCodePath, getBundleManager, getBundleName, getBundleResourcePath, getCacheDir, getCaller, getCallingAbility, getCallingBundle, getClassloader, getCodeCacheDir, getColor, getColorMode, getContext, getDatabaseDir, getDataDir, getDir, getDisplayOrientation, getDistributedDir, getElementName, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getGlobalTaskDispatcher, getHapModuleInfo, getIntArray, getLastStoredDataWhenConfigChanged, getLocalClassName, getMainTaskDispatcher, getNoBackupFilesDir, getPattern, getPreferencesDir, getProcessInfo, getProcessName, getResourceManager, getResourceManager, getString, getString, getStringArray, getTheme, getThemeId, getUITaskDispatcher, init, isCredentialEncryptedStorage, isDeviceEncryptedStorage, isUpdatingConfigurations, lockMission, printDrawnCompleted, requestPermissionsFromUser, restart, setColorMode, setDisplayOrientation, setPattern, setShowOnLockScreen, setTheme, setTransitionAnimation, setWakeUpScreen, startAbilities, startAbility, startAbility, startAbility, switchToCredentialEncryptedStorageContext, switchToDeviceEncryptedStorageContext, terminateAbility, terminateAbilityResult, unlockMission, verifyCallingOrSelfPermission, verifyCallingPermission, verifyPermission, verifySelfPermission

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

ACTION_REQUEST_UPDATE

public static final java.lang.String ACTION_REQUEST_UPDATE

Indicates the action declared for the child class of TileAbility to request an update.

This action is sent to the system when notifyDataChanged(ohos.app.Context,ohos.bundle.ElementName) is called on the child class of TileAbility to request the system to update this tile.

另请参阅:

常量字段值

ACTION_TILE

public static final java.lang.String ACTION_TILE

Indicates the action declared for the child class of TileAbility in the config.json file.

After the system recognizes this action, the tile becomes selectable and can be added to the visible tile list.

另请参阅:

常量字段值

ACTION_TILE_DEFAULT

public static final java.lang.String ACTION_TILE_DEFAULT

Indicates the action declared for the child class of TileAbility in the config.json file for a tile to be displayed in the visible tile list by default.

When an application is installed, the tile holding this application and declared with this action is automatically added to the visible tile list.

另请参阅:

常量字段值

EXTRA_CLASS_NAME

public static final java.lang.String EXTRA_CLASS_NAME

Indicates the name of the child class of TileAbility.

The child class name is sent to the system when notifyDataChanged(ohos.app.Context,ohos.bundle.ElementName) is called on the child class of TileAbility to request the system to update this tile.

另请参阅:

常量字段值

EXTRA_PACKAGE_NAME

public static final java.lang.String EXTRA_PACKAGE_NAME

Indicates the package name of the child class of TileAbility.

The package name is sent to the system when notifyDataChanged(ohos.app.Context,ohos.bundle.ElementName) is called on the child class of TileAbility to request the system to update this tile.

另请参阅:

常量字段值

EXTRA_TILE_IDS

public static final java.lang.String EXTRA_TILE_IDS

Indicates the tile ID.

The tile ID is sent to the system when notifyDataChanged(ohos.app.Context,ohos.bundle.ElementName) is called on the child class of TileAbility to request the system to update this tile.

另请参阅:

常量字段值

构造器详细资料

TileAbility

public TileAbility()

方法详细资料

onConnect

protected ohos.rpc.IRemoteObject onConnect(ohos.aafwk.content.Intent intent)

覆盖:

onConnect 在类中 ohos.aafwk.ability.Ability

onDisconnect

protected void onDisconnect(ohos.aafwk.content.Intent intent)

覆盖:

onDisconnect 在类中 ohos.aafwk.ability.Ability

onStatusChanged

protected abstract TileEntity onStatusChanged(TileStatus status)

Called when the tile state changes.

When the tile state changes, for example, the tile is selected or released, this callback is invoked to notify the TileAbility so that subsequent operations are performed based on TileStatus.

参数:

status - Indicates the tile state.

返回:

Returns a TileEntity object if this tile is in the TileStatus#TILE_SELECTED or TileStatus#TILE_UPDATE state; returns a TileEntity object or null if the tile is in any other state.

isInRetailMode

public final boolean isInRetailMode()

Checks whether the current system is in retail mode.

For some applications, different tile content needs to be displayed in retail and non-retail modes. You need to call this method if retail mode-related services need to be processed.

返回:

Returns true if the current system is in retail mode; returns false otherwise.

notifyDataChanged

public final void notifyDataChanged(ohos.app.Context context,
                                    ohos.bundle.ElementName elementName)

Notifies the system of tile data changes.

Upon receiving the notification, the tile system calls onStatusChanged(ohos.wearable.tile.TileStatus) to pass TileStatus#TILE_UPDATE to return a TileEntity object for updating.

参数:

context - Indicates the context object of the caller.

elementName - Indicates the element name of the caller, which identifies a TileAbility object.