目录

ArkTS API Error Codes

This section describes only module-specific error codes. For details about universal error codes, please refer to Universal Error Codes.

1003500001 System Error

Message

Internal error.

Symptom

This error code is reported when an internal system error occurs.

Possible causes

An internal system error occurs.

Solution

Try again or submit a ticket online.

1003500002 Marshalling or Unmarshalling Error

Message

Marshalling or unmarshalling error.

Symptom

This error code is returned when a marshalling or unmarshalling error occurs.

Possible causes

Live View Kit is abnormal.

Solution

Try again or submit a ticket online.

1003500003 Failed to Connect to the Service

Message

Failed to connect service.

Symptom

This error code is reported when an error occurs during the connection to Live View Kit.

Possible causes

Live View Kit is busy or abnormal.

Solution

Try again or submit a ticket online.

1003500004 Live View Kit Disabled

Message

LiveView is not enabled.

Symptom

This error code is reported when Live View Kit is disabled.

Possible causes

Live View Kit is disabled for the app.

Solution

Go to Settings > Apps > services, select the app, and enable Live View Kit.

1003500005 Live View Permission Not Requested

Message

The right of liveView is not enabled.

Symptom

This error code is reported when the live view permission is not requested.

Possible causes

Your app has not requested the live view permission of a specific scenario.

Solution

If your app has requested the live view permission, ensure that the event field matches the scenario for which the permission is requested. If your app has not requested the live view permission, request it by referring to Preparations.

1003500006 Live View Already Exists

Message

The liveView already exists.

Symptom

This error code is reported when the user attempts to create a live view with a duplicate ID.

Possible causes

The ID of the live view to be created is the same as an existing one.

Solution

Change the live view ID.

1003500007 Unable to Connect to the Server

Message

Couldn't connect to server.

Symptom

This error code is reported when the network is unavailable.

Possible causes

The device is not connected to the network.

Solution

Verify the network.

1003500008 Live View Creation or Update Frequency Exceeds Limit

Message

Over max number liveViews per second.

Symptom

This error code is reported when the live view creation or update frequency exceeds the limit.

Possible causes

For the same app, the live view creation frequency exceeds 10 per second or the live view update frequency exceeds 20 per second.

Solution

Reduce the live view call frequency.

1003500009 Live View ID Does Not Exist

Message

The liveView does not exist.

Symptom

This error code is reported when the live view ID does not exist.

Possible causes

The live view ID does not exist or the live view has been deleted.

Solution

  1. Check whether the live view creation is successful.
  2. If the creation is successful, check whether the live view exists in the notification panel on the device. If no, stop calling the corresponding API using this live view ID.

1003500010 Live View Ended

Message

The liveView has ended.

Symptom

This error code is reported when you try to update or end a live view that has been ended.

Possible causes

After a live view is ended through liveViewManager.stopLiveView, it is still stored in the notification panel within the duration specified by keepTime. In this case, the liveViewManager.updateLiveView or liveViewManager.stopLiveView API is called to update or end a live view with the same ID.

Solution

When keepTime is specified and the app has called liveViewManager.stopLiveView to end a live view, do not call the live view update or ending API using the ID of this live view while the live view still remains in the notification panel.

1003500011 Incorrect Live View Sequence

Message

The liveView sequence is incorrect.

Symptom

This error code is reported when the new sequence number for updating or ending a live view is less than or equal to the current sequence number.

Possible causes

The new sequence number for updating or ending a live view is less than or equal to the current sequence number.

Solution

Change the sequence and try to update or end the live view again.

1003500017 Number of Condition-triggered Live Views Exceeds the Limit

Message

Over max number liveViews by trigger.

Symptom

The number of condition-triggered live views exceeds the maximum limit.

Possible causes

You have sent more than five condition-triggered live view messages.

Solution

A maximum of five geofence-triggered live view messages are allowed per app, per device, per day. Wait until the next day to send other condition-triggered live view messages.

1003500018 Location-based Live View Alert Disabled

Message

Geofencing-based liveView is not enabled.

Symptom

The location-based live view alert is disabled.

Possible causes

The user has disabled the location-based live view alert.

Solution

Ask the user to enable the location-based live view alert. Then send the geofence-triggered live view message. To enable this function, go to Settings > Notifications & status bar > Live view, tap the four-dot icon in the upper right corner of the screen, tap Personalized alerts, and enable Show location-based alerts.

1003500019 Location Switch Disabled

Message

The location switch is off.

Symptom

The location switch is disabled, leading to geofence registration failure.

Possible causes

The location switch is disabled. As a result, features such as continuous location, single location, and geofencing are unavailable

Solution

Ask the user to go to Settings > Privacy & security and enable the location switch.

1003500020 Awareness & suggestions Switch Disabled

Message

The "Awareness & suggestions" switch of the location-based service is turned off.

Symptom

The Awareness & suggestions switch of the location service is disabled, leading to geofence registration failure.

Possible causes

The Awareness & suggestions switch is disabled in the system settings path: Settings > Privacy & security > Location > System services.

Solution

Ask the user to go to Settings > Privacy & security > Location > System services (scroll to the bottom of the screen) and enable the Awareness & suggestions switch.

1003500021 Failed to Find the ExtensionAbility of the Custom Extension Area of the Live View Widget

Message

The system failed to find the ExtensionAbility instance for the custom Live View widget template.

Symptom

The LiveViewCardExtensionAbility of the custom extension area of the live view widget cannot be found. As a result, the live view widget fails to be created.

Possible causes

When you create a custom extension area of a live view widget, the passed CustomLayout.abilityName does not exist.

Solution

  1. Create an ExtensionAbility component in the project, which inherits from LiveViewCardExtensionAbility.
  2. When creating a custom extension area of a live view widget, ensure that the passed CustomLayout.abilityName is the name of the ExtensionAbility component you created.