資源管理模塊,根據(jù)當前configuration:語言、區(qū)域、橫豎屏、Mcc(移動國家碼)和Mnc(移動網(wǎng)絡碼)、Device capability(設備類型)、Density(分辨率)提供獲取應用資源信息讀取接口。
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。
從API Version9開始,Stage模型通過context獲取resourceManager對象的方式后,可直接調用其內部獲取資源的接口,無需再導入包。此方式FA模型不適用,F(xiàn)A模型還需要先導入包,再調用getResourceManager接口獲取資源對象。
Stage模型下Context的引用方法請參考Stage模型的Context詳細介紹。
- import UIAbility from '@ohos.app.ability.UIAbility';
- export default class EntryAbility extends UIAbility {
- onWindowStageCreate(windowStage) {
- let context = this.context;
- let resourceManager = context.resourceManager;
- }
- }
getResourceManager(callback: AsyncCallback<ResourceManager>): void
獲取當前應用的資源管理對象,使用callback形式返回ResourceManager對象。
模型約束:此接口僅可在FA模型下使用。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<ResourceManager> | 是 | callback方式返回ResourceManager對象 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- if (error != null) {
- console.log("error is " + error);
- return;
- }
- mgr.getString(0x1000000, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- });
注:示例代碼中的0x1000000表示資源對應的id, 其可在編譯后的文件ResourceTable.txt中找到。
getResourceManager(bundleName: string, callback: AsyncCallback<ResourceManager>): void
獲取指定應用的資源管理對象,使用callback形式返回ResourceManager對象。
模型約束:此接口僅可在FA模型下使用。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
bundleName | string | 是 | 指定應用的Bundle名稱 |
callback | AsyncCallback<ResourceManager> | 是 | callback方式返回ResourceManager對象 |
示例:
- resourceManager.getResourceManager("com.example.myapplication", (error, mgr) => {
- });
getResourceManager(): Promise<ResourceManager>
獲取當前應用的資源管理對象,使用Promise形式返回ResourceManager對象。
模型約束:此接口僅可在FA模型下使用。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
返回值:
類型 | 說明 |
---|---|
Promise<ResourceManager> | Promise方式返回資源管理對象 |
示例:
- resourceManager.getResourceManager().then(mgr => {
- mgr.getString(0x1000000, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- }).catch(error => {
- console.log("error is " + error);
- });
注:示例代碼中的0x1000000表示資源對應的id, 其可在編譯后的文件ResourceTable.txt中找到。
getResourceManager(bundleName: string): Promise<ResourceManager>
獲取指定應用的資源管理對象,使用Promise形式返回ResourceManager對象。
模型約束:此接口僅可在FA模型下使用。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
bundleName | string | 是 | 指定應用的Bundle名稱 |
返回值:
類型 | 說明 |
---|---|
Promise<ResourceManager> | Promise方式返回的資源管理對象 |
示例:
- resourceManager.getResourceManager("com.example.myapplication").then(mgr => {
- }).catch(error => {
- });
用于表示設備屏幕方向。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
名稱 | 值 | 說明 |
---|---|---|
DIRECTION_VERTICAL | 0 | 豎屏 |
DIRECTION_HORIZONTAL | 1 | 橫屏 |
用于表示當前設備類型。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
名稱 | 值 | 說明 |
---|---|---|
DEVICE_TYPE_PHONE | 0x00 | 手機 |
DEVICE_TYPE_TABLET | 0x01 | 平板 |
DEVICE_TYPE_CAR | 0x02 | 汽車 |
DEVICE_TYPE_PC | 0x03 | 電腦 |
DEVICE_TYPE_TV | 0x04 | 電視 |
DEVICE_TYPE_WEARABLE | 0x06 | 穿戴 |
用于表示當前設備屏幕密度。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
名稱 | 值 | 說明 |
---|---|---|
SCREEN_SDPI | 120 | 小規(guī)模的屏幕密度 |
SCREEN_MDPI | 160 | 中規(guī)模的屏幕密度 |
SCREEN_LDPI | 240 | 大規(guī)模的屏幕密度 |
SCREEN_XLDPI | 320 | 特大規(guī)模的屏幕密度 |
SCREEN_XXLDPI | 480 | 超大規(guī)模的屏幕密度 |
SCREEN_XXXLDPI | 640 | 超特大規(guī)模的屏幕密度 |
表示當前設備的狀態(tài)。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
名稱 | 類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
direction | 是 | 否 | 當前設備屏幕方向 | |
locale | string | 是 | 否 | 當前系統(tǒng)語言 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getConfiguration((error, value) => {
- let direction = value.direction;
- let locale = value.locale;
- });
- });
表示設備支持的能力。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
名稱 | 類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
screenDensity | 是 | 否 | 當前設備屏幕密度 | |
deviceType | 是 | 否 | 當前設備類型 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getDeviceCapability((error, value) => {
- let screenDensity = value.screenDensity;
- let deviceType = value.deviceType;
- });
- });
表示rawfile的descriptor信息。
系統(tǒng)能力: SystemCapability.Global.ResourceManager
參數(shù):
名稱 | 類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
fd | number | 是 | 否 | rawfile的descriptor |
offset | number | 是 | 否 | rawfile的起始偏移量 |
length | number | 是 | 否 | rawfile的文件長度 |
表示的資源信息。
系統(tǒng)能力: 以下各項對應的系統(tǒng)能力均為SystemCapability.Global.ResourceManager
參數(shù):
名稱 | 類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
bundleName | string | 是 | 否 | 應用的bundle名稱 |
moduleName | string | 是 | 否 | 應用的module名稱 |
id | number | 是 | 否 | 資源的id值 |
提供訪問應用資源的能力。
ResourceManager涉及到的方法,僅限基于TS擴展的聲明式開發(fā)范式使用。
資源文件在工程的resources目錄中定義,id可通過$r(資源地址).id的方式獲取,例如$r('app.string.test').id。
getStringValue(resId: number, callback: AsyncCallback<string>): void
用戶獲取指定資源ID對應的字符串,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的字符串 |
錯誤碼:
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the module resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例Stage:
- try {
- this.context.resourceManager.getStringValue($r('app.string.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringValue(resId: number): Promise<string>
用戶獲取指定資源ID對應的字符串,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源ID值對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringValue($r('app.string.test').id).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getStringValue promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringValue(resource: Resource, callback: AsyncCallback<string>): void
用戶獲取指定resource對象對應的字符串,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.string.test').id
- };
- try {
- this.context.resourceManager.getStringValue(resource, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringValue(resource: Resource): Promise<string>
用戶獲取指定resource對象對應的字符串,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | resource對象對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.string.test').id
- };
- try {
- this.context.resourceManager.getStringValue(resource).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getStringValue promise error is " + error);
- });
- } catch (error) {
- console.error(`callback getStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayValue(resId: number, callback: AsyncCallback<Array<string>>): void
用戶獲取指定資源ID對應的字符串數(shù)組,使用callback形式返回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<Array<string>> | 是 | 異步回調,用于返回獲取的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringArrayValue($r('app.strarray.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let strArray = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringArrayValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayValue(resId: number): Promise<Array<string>>
用戶獲取指定資源ID對應的字符串數(shù)組,使用Promise形式返回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | 資源ID值對應的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringArrayValue($r('app.strarray.test').id).then(value => {
- let strArray = value;
- }).catch(error => {
- console.log("getStringArrayValue promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getStringArrayValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayValue(resource: Resource, callback: AsyncCallback<Array<string>>): void
用戶獲取指定resource對象對應的字符串數(shù)組,使用callback形式返回回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
callback | AsyncCallback<Array<string>> | 是 | 異步回調,用于返回獲取的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.strarray.test').id
- };
- try {
- this.context.resourceManager.getStringArrayValue(resource, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let strArray = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringArrayValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayValue(resource: Resource): Promise<Array<string>>
用戶獲取指定resource對象對應的字符串數(shù)組,使用Promise形式返回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | resource對象對應的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.strarray.test').id
- };
- try {
- this.context.resourceManager.getStringArrayValue(resource).then(value => {
- let strArray = value;
- }).catch(error => {
- console.log("getStringArray promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getStringArrayValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContent(resId: number, callback: AsyncCallback<Uint8Array>): void
用戶獲取指定資源ID對應的媒體文件內容,使用callback形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- try {
- this.context.resourceManager.getMediaContent($r('app.media.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`callback getMediaContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContent(resId: number): Promise<Uint8Array>
用戶獲取指定資源ID對應的媒體文件內容,使用Promise形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | 資源ID值對應的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- try {
- this.context.resourceManager.getMediaContent($r('app.media.test').id).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaContent promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContent(resource: Resource, callback: AsyncCallback<Uint8Array>): void
用戶獲取指定resource對象對應的媒體文件內容,使用callback形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.media.test').id
- };
- try {
- this.context.resourceManager.getMediaContent(resource, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`callback getMediaContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContent(resource: Resource): Promise<Uint8Array>
用戶獲取指定resource對象對應的媒體文件內容,使用Promise形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | resource對象對應的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.media.test').id
- };
- try {
- this.context.resourceManager.getMediaContent(resource).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaContent promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContentBase64(resId: number, callback: AsyncCallback<string>): void
用戶獲取指定資源ID對應的圖片資源Base64編碼,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- try {
- this.context.resourceManager.getMediaContentBase64($r('app.media.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`callback getMediaContentBase64 failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContentBase64(resId: number): Promise<string>
用戶獲取指定資源ID對應的圖片資源Base64編碼,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源ID值對應的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- try {
- this.context.resourceManager.getMediaContentBase64($r('app.media.test').id).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaContentBase64 promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaContentBase64 failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContentBase64(resource: Resource, callback: AsyncCallback<string>): void
用戶獲取指定resource對象對應的圖片資源Base64編碼,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.media.test').id
- };
- try {
- this.context.resourceManager.getMediaContentBase64(resource, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`promise getMediaContentBase64 failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaContentBase64(resource: Resource): Promise<string>
用戶獲取指定resource對象對應的圖片資源Base64編碼,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | resource對象對應的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.media.test').id
- };
- try {
- this.context.resourceManager.getMediaContentBase64(resource).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaContentBase64 promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaContentBase64 failed, error code: ${error.code}, message: ${error.message}.`)
- }
getConfiguration(callback: AsyncCallback<Configuration>): void
用戶獲取設備的Configuration,使用callback形式返回Configuration對象。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<Configuration> | 是 | 異步回調,用于返回設備的Configuration |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getConfiguration((error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let direction = value.direction;
- let locale = value.locale;
- }
- });
- });
getConfiguration(): Promise<Configuration>
用戶獲取設備的Configuration,使用Promise形式返回Configuration對象。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
返回值:
類型 | 說明 |
---|---|
Promise<Configuration> | 設備的Configuration |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getConfiguration().then(value => {
- let direction = value.direction;
- let locale = value.locale;
- }).catch(error => {
- console.log("getConfiguration promise error is " + error);
- });
- });
getDeviceCapability(callback: AsyncCallback<DeviceCapability>): void
用戶獲取設備的DeviceCapability,使用callback形式返回DeviceCapability對象。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<DeviceCapability> | 是 | 異步回調,用于返回設備的DeviceCapability |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getDeviceCapability((error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let screenDensity = value.screenDensity;
- let deviceType = value.deviceType;
- }
- });
- });
getDeviceCapability(): Promise<DeviceCapability>
用戶獲取設備的DeviceCapability,使用Promise形式返回DeviceCapability對象。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
返回值:
類型 | 說明 |
---|---|
Promise<DeviceCapability> | 設備的DeviceCapability |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getDeviceCapability().then(value => {
- let screenDensity = value.screenDensity;
- let deviceType = value.deviceType;
- }).catch(error => {
- console.log("getDeviceCapability promise error is " + error);
- });
- });
getPluralStringValue(resId: number, num: number, callback: AsyncCallback<string>): void
根據(jù)指定數(shù)量獲取指定ID字符串表示的單復數(shù)字符串,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
num | number | 是 | 數(shù)量值 |
callback | AsyncCallback<string> | 是 | 異步回調,返回根據(jù)指定數(shù)量獲取指定ID字符串表示的單復數(shù)字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getPluralStringValue($r("app.plural.test").id, 1, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- } catch (error) {
- console.error(`callback getPluralStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getPluralStringValue(resId: number, num: number): Promise<string>
根據(jù)指定數(shù)量獲取對指定ID字符串表示的單復數(shù)字符串,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
num | number | 是 | 數(shù)量值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 根據(jù)提供的數(shù)量獲取對應ID字符串表示的單復數(shù)字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getPluralStringValue($r("app.plural.test").id, 1).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getPluralStringValue promise error is " + error);
- });
- } catch (error) {
- console.error(`callback getPluralStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getPluralStringValue(resource: Resource, num: number, callback: AsyncCallback<string>): void
根據(jù)指定數(shù)量獲取指定resource對象表示的單復數(shù)字符串,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
num | number | 是 | 數(shù)量值 |
callback | AsyncCallback<string> | 是 | 異步回調,返回根據(jù)指定數(shù)量獲取指定resource對象表示的單復數(shù)字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.plural.test').id
- };
- try {
- this.context.resourceManager.getPluralStringValue(resource, 1, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- } catch (error) {
- console.error(`callback getPluralStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getPluralString(resource: Resource, num: number): Promise<string>
根據(jù)指定數(shù)量獲取對指定resource對象表示的單復數(shù)字符串,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 | |
num | number | 是 | 數(shù)量值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 根據(jù)提供的數(shù)量獲取對應resource對象表示的單復數(shù)字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.plural.test').id
- };
- try {
- this.context.resourceManager.getPluralString(resource, 1).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getPluralString promise error is " + error);
- });
- } catch (error) {
- console.error(`callback getPluralStringValue failed, error code: ${error.code}, message: ${error.message}.`)
- }
getRawFileContent(path: string, callback: AsyncCallback<Uint8Array>): void
用戶獲取resources/rawfile目錄下對應的rawfile文件內容,使用callback形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的rawfile文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | If the resource not found by path. |
示例:
- try {
- this.context.resourceManager.getRawFileContent("test.xml", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let rawFile = value;
- }
- });
- } catch (error) {
- console.error(`callback getRawFileContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getRawFileContent(path: string): Promise<Uint8Array>
用戶獲取resources/rawfile目錄下對應的rawfile文件內容,使用Promise形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | rawfile文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | If the resource not found by path. |
示例:
- try {
- this.context.resourceManager.getRawFileContent("test.xml").then(value => {
- let rawFile = value;
- }).catch(error => {
- console.log("getRawFileContent promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getRawFileContent failed, error code: ${error.code}, message: ${error.message}.`)
- }
getRawFd(path: string, callback: AsyncCallback<RawFileDescriptor>): void
用戶獲取resources/rawfile目錄下對應rawfile文件的descriptor,使用callback形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<RawFileDescriptor> | 是 | 異步回調,用于返回獲取的rawfile文件的descriptor |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | If the resource not found by path. |
示例:
- try {
- this.context.resourceManager.getRawFd("test.xml", (error, value) => {
- if (error != null) {
- console.log(`callback getRawFd failed error code: ${error.code}, message: ${error.message}.`);
- } else {
- let fd = value.fd;
- let offset = value.offset;
- let length = value.length;
- }
- });
- } catch (error) {
- console.error(`callback getRawFd failed, error code: ${error.code}, message: ${error.message}.`)
- };
getRawFd(path: string): Promise<RawFileDescriptor>
用戶獲取resources/rawfile目錄下對應rawfile文件的descriptor,使用Promise形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<RawFileDescriptor> | rawfile文件descriptor |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | If the resource not found by path. |
示例:
- try {
- this.context.resourceManager.getRawFd("test.xml").then(value => {
- let fd = value.fd;
- let offset = value.offset;
- let length = value.length;
- }).catch(error => {
- console.log(`promise getRawFd error error code: ${error.code}, message: ${error.message}.`);
- });
- } catch (error) {
- console.error(`promise getRawFd failed, error code: ${error.code}, message: ${error.message}.`);
- };
closeRawFileDescriptor(path: string, callback: AsyncCallback<void>): void
用戶關閉resources/rawfile目錄下rawfile文件的descriptor,使用callback形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<void> | 是 | 異步回調 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.closeRawFileDescriptor("test.xml", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- }
- });
- });
closeRawFileDescriptor(path: string): Promise<void>
用戶關閉resources/rawfile目錄下rawfile文件的descriptor,使用Promise形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<void> | 無返回值 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.closeRawFileDescriptor("test.xml").then(value => {
- let result = value;
- }).catch(error => {
- console.log("closeRawFileDescriptor promise error is " + error);
- });
- });
closeRawFd(path: string, callback: AsyncCallback<void>): void
用戶關閉resources/rawfile目錄下rawfile文件的descriptor,使用callback形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<void> | 是 | 異步回調 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | The resource not found by path. |
示例:
- try {
- this.context.resourceManager.closeRawFd("test.xml", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- }
- });
- } catch (error) {
- console.error(`callback closeRawFd failed, error code: ${error.code}, message: ${error.message}.`)
- }
closeRawFd(path: string): Promise<void>
用戶關閉resources/rawfile目錄下rawfile文件的descriptor,使用Promise形式返回。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<void> | 無返回值 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001005 | If the resource not found by path. |
示例:
- try {
- this.context.resourceManager.closeRawFd("test.xml").then(value => {
- let result = value;
- }).catch(error => {
- console.log("closeRawFd promise error is " + error);
- });
- } catch (error) {
- console.error(`promise closeRawFd failed, error code: ${error.code}, message: ${error.message}.`)
- }
release()
用戶釋放創(chuàng)建的resourceManager。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.release();
- });
getStringByName(resName: string, callback: AsyncCallback<string>): void
用戶獲取指定資源名稱對應的字符串,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringByName("test", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let string = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringByName(resName: string): Promise<string>
用戶獲取指定資源名稱對應的字符串,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源名稱對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringByName("test").then(value => {
- let string = value;
- }).catch(error => {
- console.log("getStringByName promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getStringByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayByName(resName: string, callback: AsyncCallback<Array<string>>): void
用戶獲取指定資源名稱對應的字符串數(shù)組,使用callback形式返回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
callback | AsyncCallback<Array<string>> | 是 | 異步回調,用于返回獲取的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringArrayByName("test", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let strArray = value;
- }
- });
- } catch (error) {
- console.error(`callback getStringArrayByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringArrayByName(resName: string): Promise<Array<string>>
用戶獲取指定資源名稱對應的字符串數(shù)組,使用Promise形式返回字符串數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | 資源名稱對應的字符串數(shù)組 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringArrayByName("test").then(value => {
- let strArray = value;
- }).catch(error => {
- console.log("getStringArrayByName promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getStringArrayByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaByName(resName: string, callback: AsyncCallback<Uint8Array>): void
用戶獲取指定資源名稱對應的媒體文件內容,使用callback形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getMediaByName("test", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`callback getMediaByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaByName(resName: string): Promise<Uint8Array>
用戶獲取指定資源名稱對應的媒體文件內容,使用Promise形式返回字節(jié)數(shù)組。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | 資源名稱對應的媒體文件內容 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getMediaByName("test").then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaByName promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaBase64ByName(resName: string, callback: AsyncCallback<string>): void
用戶獲取指定資源名稱對應的圖片資源Base64編碼,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getMediaBase64ByName("test", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- } catch (error) {
- console.error(`callback getMediaBase64ByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getMediaBase64ByName(resName: string): Promise<string>
用戶獲取指定資源名稱對應的圖片資源Base64編碼,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源名稱對應的圖片資源Base64編碼 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getMediaBase64ByName("test").then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaBase64ByName promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getMediaBase64ByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getPluralStringByName(resName: string, num: number, callback: AsyncCallback<string>): void
根據(jù)傳入的數(shù)量值,獲取資源名稱對應的字符串資源,使用callback形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
num | number | 是 | 數(shù)量值 |
callback | AsyncCallback<string> | 是 | 異步回調,返回根據(jù)傳入的數(shù)量值獲取資源名稱對應的字符串資源 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getPluralStringByName("test", 1, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- } catch (error) {
- console.error(`callback getPluralStringByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getPluralStringByName(resName: string, num: number): Promise<string>
根據(jù)傳入的數(shù)量值,獲取資源名稱對應的字符串資源,使用Promise形式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
num | number | 是 | 數(shù)量值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 根據(jù)傳入的數(shù)量值獲取資源名稱對應的字符串資源 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getPluralStringByName("test", 1).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getPluralStringByName promise error is " + error);
- });
- } catch (error) {
- console.error(`promise getPluralStringByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringSync(resId: number): string
用戶獲取指定資源ID對應的字符串,使用同步方式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
string | 資源ID值對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringSync($r('app.string.test').id);
- } catch (error) {
- console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringSync(resource: Resource): string
用戶獲取指定resource對象對應的字符串,使用同步方式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
string | resource對象對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.string.test').id
- };
- try {
- this.context.resourceManager.getStringSync(resource);
- } catch (error) {
- console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
- }
getStringByNameSync(resName: string): string
用戶獲取指定資源名稱對應的字符串,使用同步方式返回字符串。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
string | 資源名稱對應的字符串 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getStringByNameSync("test");
- } catch (error) {
- console.error(`getStringByNameSync failed, error code: ${error.code}, message: ${error.message}.`)
- }
getBoolean(resId: number): boolean
使用同步方式,返回獲取指定資源ID對應的布爾結果。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
boolean | 資源ID值對應的布爾結果 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getBoolean($r('app.boolean.boolean_test').id);
- } catch (error) {
- console.error(`getBoolean failed, error code: ${error.code}, message: ${error.message}.`)
- }
getBoolean(resource: Resource): boolean
使用同步方式,返回獲取指定resource對象對應的布爾結果。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
boolean | resource對象對應的布爾結果 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.boolean.boolean_test').id
- };
- try {
- this.context.resourceManager.getBoolean(resource);
- } catch (error) {
- console.error(`getBoolean failed, error code: ${error.code}, message: ${error.message}.`)
- }
getBooleanByName(resName: string): boolean
使用同步方式,返回獲取指定資源名稱對應的布爾結果
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
boolean | 資源名稱對應的布爾結果 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getBooleanByName("boolean_test");
- } catch (error) {
- console.error(`getBooleanByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getNumber(resId: number): number
用戶獲取指定資源ID對應的integer數(shù)值或者float數(shù)值,使用同步方式返回資源對應的數(shù)值。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
number | 資源ID值對應的數(shù)值。Integer對應的是原數(shù)值,float對應的是真實像素點值,具體參考示例代碼。 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getNumber($r('app.integer.integer_test').id); // integer對應返回的是原數(shù)值
- } catch (error) { console.error(`getNumber failed, error code: ${error.code}, message: ${error.message}.`)
- }
- try {
- this.context.resourceManager.getNumber($r('app.float.float_test').id); // float對應返回的是真實像素點值
- } catch (error) { console.error(`getNumber failed, error code: ${error.code}, message: ${error.message}.`)
- }
getNumber(resource: Resource): number
用戶獲取指定resource對象對應的integer數(shù)值或者float數(shù)值,使用同步方式返回資源對應的數(shù)值。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resource | 是 | 資源信息 |
返回值:
類型 | 說明 |
---|---|
number | resource對象對應的數(shù)值。Integer對應的是原數(shù)值,float對應的是真實像素點值,具體參考示例代碼。 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001001 | If the resId invalid. |
9001002 | If the resource not found by resId. |
9001006 | If the resource re-ref too much. |
示例:
- let resource = {
- bundleName: "com.example.myapplication",
- moduleName: "entry",
- id: $r('app.integer.integer_test').id};
- try {
- this.context.resourceManager.getNumber(resource);// integer對應返回的是原數(shù)值, float對應返回的是真實像素點值
- } catch (error) {
- console.error(`getNumber failed, error code: ${error.code}, message: ${error.message}.`)
- }
getNumberByName(resName: string): number
用戶獲取指定資源名稱對應的integer數(shù)值或者float數(shù)值,使用同步方式資源對應的數(shù)值。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resName | string | 是 | 資源名稱 |
返回值:
類型 | 說明 |
---|---|
number | 資源名稱對應的數(shù)值 |
以下錯誤碼的詳細介紹請參見資源管理錯誤碼。
錯誤碼:
錯誤碼ID | 錯誤信息 |
---|---|
9001003 | If the resName invalid. |
9001004 | If the resource not found by resName. |
9001006 | If the resource re-ref too much. |
示例:
- try {
- this.context.resourceManager.getNumberByName("integer_test");
- } catch (error) {
- console.error(`getNumberByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
- try {
- this.context.resourceManager.getNumberByName("float_test");
- } catch (error) {
- console.error(`getNumberByName failed, error code: ${error.code}, message: ${error.message}.`)
- }
getString(resId: number, callback: AsyncCallback<string>): void
用戶獲取指定資源ID對應的字符串,使用callback形式返回字符串。
從API version 9開始不再維護,建議使用getStringValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的字符串 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getString($r('app.string.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- });
getString(resId: number): Promise<string>
用戶獲取指定資源ID對應的字符串,使用Promise形式返回字符串。
從API version 9開始不再維護,建議使用getStringValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源ID值對應的字符串 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getString($r('app.string.test').id).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getstring promise error is " + error);
- });
- });
getStringArray(resId: number, callback: AsyncCallback<Array<string>>): void
用戶獲取指定資源ID對應的字符串數(shù)組,使用callback形式返回字符串數(shù)組。
從API version 9開始不再維護,建議使用getStringArrayValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<Array<string>> | 是 | 異步回調,用于返回獲取的字符串數(shù)組 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getStringArray($r('app.strarray.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let strArray = value;
- }
- });
- });
getStringArray(resId: number): Promise<Array<string>>
用戶獲取指定資源ID對應的字符串數(shù)組,使用Promise形式返回字符串數(shù)組。
從API version 9開始不再維護,建議使用getStringArrayValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | 資源ID值對應的字符串數(shù)組 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getStringArray($r('app.strarray.test').id).then(value => {
- let strArray = value;
- }).catch(error => {
- console.log("getStringArray promise error is " + error);
- });
- });
getMedia(resId: number, callback: AsyncCallback<Uint8Array>): void
用戶獲取指定資源ID對應的媒體文件內容,使用callback形式返回字節(jié)數(shù)組。
從API version 9開始不再維護,建議使用getMediaContent代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的媒體文件內容 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getMedia($r('app.media.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- });
getMedia(resId: number): Promise<Uint8Array>
用戶獲取指定資源ID對應的媒體文件內容,使用Promise形式返回字節(jié)數(shù)組。
從API version 9開始不再維護,建議使用getMediaContent代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | 資源ID值對應的媒體文件內容 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getMedia($r('app.media.test').id).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMedia promise error is " + error);
- });
- });
getMediaBase64(resId: number, callback: AsyncCallback<string>): void
用戶獲取指定資源ID對應的圖片資源Base64編碼,使用callback形式返回字符串。
從API version 9開始不再維護,建議使用getMediaContentBase64代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
callback | AsyncCallback<string> | 是 | 異步回調,用于返回獲取的圖片資源Base64編碼 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getMediaBase64($r('app.media.test').id, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let media = value;
- }
- });
- });
getMediaBase64(resId: number): Promise<string>
用戶獲取指定資源ID對應的圖片資源Base64編碼,使用Promise形式返回字符串。
從API version 9開始不再維護,建議使用getMediaContentBase64代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 資源ID值對應的圖片資源Base64編碼 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getMediaBase64($r('app.media.test').id).then(value => {
- let media = value;
- }).catch(error => {
- console.log("getMediaBase64 promise error is " + error);
- });
- });
getPluralString(resId: number, num: number): Promise<string>
根據(jù)指定數(shù)量獲取對指定ID字符串表示的單復數(shù)字符串,使用Promise形式返回字符串。
從API version 9開始不再維護,建議使用getPluralStringValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
num | number | 是 | 數(shù)量值 |
返回值:
類型 | 說明 |
---|---|
Promise<string> | 根據(jù)提供的數(shù)量獲取對應ID字符串表示的單復數(shù)字符串 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getPluralString($r("app.plural.test").id, 1).then(value => {
- let str = value;
- }).catch(error => {
- console.log("getPluralString promise error is " + error);
- });
- });
getPluralString(resId: number, num: number, callback: AsyncCallback<string>): void
根據(jù)指定數(shù)量獲取指定ID字符串表示的單復數(shù)字符串,使用callback形式返回字符串。
從API version 9開始不再維護,建議使用getPluralStringValue代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
resId | number | 是 | 資源ID值 |
num | number | 是 | 數(shù)量值 |
callback | AsyncCallback<string> | 是 | 異步回調,返回根據(jù)指定數(shù)量獲取指定ID字符串表示的單復數(shù)字符串 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getPluralString($r("app.plural.test").id, 1, (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let str = value;
- }
- });
- });
getRawFile(path: string, callback: AsyncCallback<Uint8Array>): void
用戶獲取resources/rawfile目錄下對應的rawfile文件內容,使用callback形式返回字節(jié)數(shù)組。
從API version 9開始不再維護,建議使用getRawFileContent代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<Uint8Array> | 是 | 異步回調,用于返回獲取的rawfile文件內容 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getRawFile("test.xml", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let rawFile = value;
- }
- });
- });
getRawFile(path: string): Promise<Uint8Array>
用戶獲取resources/rawfile目錄下對應的rawfile文件內容,使用Promise形式返回字節(jié)數(shù)組。
從API version 9開始不再維護,建議使用getRawFileContent代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<Uint8Array> | rawfile文件內容 |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getRawFile("test.xml").then(value => {
- let rawFile = value;
- }).catch(error => {
- console.log("getRawFile promise error is " + error);
- });
- });
getRawFileDescriptor(path: string, callback: AsyncCallback<RawFileDescriptor>): void
用戶獲取resources/rawfile目錄下對應rawfile文件的descriptor,使用callback形式返回。
從API version 9開始不再維護,建議使用getRawFd代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
callback | AsyncCallback<RawFileDescriptor> | 是 | 異步回調,用于返回獲取的rawfile文件的descriptor |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getRawFileDescriptor("test.xml", (error, value) => {
- if (error != null) {
- console.log("error is " + error);
- } else {
- let fd = value.fd;
- let offset = value.offset;
- let length = value.length;
- }
- });
- });
getRawFileDescriptor(path: string): Promise<RawFileDescriptor>
用戶獲取resources/rawfile目錄下對應rawfile文件的descriptor,使用Promise形式返回。
從API version 9開始不再維護,建議使用getRawFd代替。
系統(tǒng)能力:SystemCapability.Global.ResourceManager
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
path | string | 是 | rawfile文件路徑 |
返回值:
類型 | 說明 |
---|---|
Promise<RawFileDescriptor> | rawfile文件descriptor |
示例:
- resourceManager.getResourceManager((error, mgr) => {
- mgr.getRawFileDescriptor("test.xml").then(value => {
- let fd = value.fd;
- let offset = value.offset;
- let length = value.length;
- }).catch(error => {
- console.log("getRawFileDescriptor promise error is " + error);
- });
更多建議: