Runninglock鎖

該模塊主要提供Runninglock鎖相關(guān)操作的接口，包括創(chuàng)建、查詢、持鎖、釋放鎖等操作。

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨標(biāo)記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import runningLock from '@ohos.runningLock';

RunningLockType

RunningLock鎖的類型。

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.PowerManager.PowerManager.Core

isRunningLockTypeSupported

isRunningLockTypeSupported(type: RunningLockType, callback: AsyncCallback): void

查詢系統(tǒng)是否支持該類型的鎖。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

runningLock.isRunningLockTypeSupported(runningLock.RunningLockType.BACKGROUND, (error, supported) = > {
    if (typeof error === "undefined") {
        console.info('BACKGROUND support status is ' + supported);
    } else {
        console.log('error: ' + error);
    }
})

isRunningLockTypeSupported

isRunningLockTypeSupported(type: RunningLockType): Promise

查詢系統(tǒng)是否支持該類型的鎖。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

返回值：

示例：

runningLock.isRunningLockTypeSupported(runningLock.RunningLockType.PROXIMITY_SCREEN_CONTROL)
.then(supported = > {
    console.info('PROXIMITY_SCREEN_CONTROL support status is ' + supported);
})
.catch(error = > {
    console.log('error: ' + error);
});

createRunningLock

createRunningLock(name: string, type: RunningLockType, callback: AsyncCallback): void

創(chuàng)建RunningLock鎖。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

需要權(quán)限： ohos.permission.RUNNING_LOCK

參數(shù)：

示例：

runningLock.createRunningLock("running_lock_test", runningLock.RunningLockType.BACKGROUND, (error, lockIns) = > {
    if (typeof error === "undefined") {
        console.log('create runningLock test error: ' + error);
    } else {
        var used = lockIns.isUsed();
        console.info('runninglock is used: ' + used);
        lockIns.lock(500);
        used = lockIns.isUsed();
        console.info('after lock runninglock is used ' + used);
    }
})

createRunningLock

createRunningLock(name: string, type: RunningLockType): Promise

創(chuàng)建Runninglock鎖。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

需要權(quán)限： ohos.permission.RUNNING_LOCK

參數(shù)：

返回值：

示例：

runningLock.createRunningLock("running_lock_test", runningLock.RunningLockType.BACKGROUND)
.then(runninglock = > {
    console.info('create runningLock success');
})
.catch(error = > {
    console.log('create runningLock test error: ' + error);
})

RunningLock

阻止系統(tǒng)休眠的鎖。

lock

lock(timeout: number): void

鎖定和持有RunningLock。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

需要權(quán)限： ohos.permission.RUNNING_LOCK

參數(shù)：

示例：

runningLock.createRunningLock("running_lock_test", runningLock.RunningLockType.BACKGROUND)
.then(runningLock = > {
    runningLock.lock(100)
    console.info('create runningLock success')
})
.catch(error = > {
    console.log('create runningLock test error: ' + error)
});

unlock

unlock(): void

釋放Runninglock鎖。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

需要權(quán)限： ohos.permission.RUNNING_LOCK

示例：

runningLock.createRunningLock("running_lock_test", runningLock.RunningLockType.BACKGROUND)
.then(runningLock = > {
    runningLock.unlock()
    console.info('create and unLock runningLock success')
})
.catch(error = > {
    console.log('create runningLock test error: ' + error)
});

isUsed

isUsed(): boolean

查詢當(dāng)前Runninglock是持有狀態(tài)還是釋放狀態(tài)。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

返回值：

示例：

runningLock.createRunningLock("running_lock_test", runningLock.RunningLockType.BACKGROUND)
.then(runningLock = > {
    var used = runningLock.isUsed()
    console.info('runningLock used status: ' + used)
})
.catch(error = > {
    console.log('runningLock isUsed test error: ' + error)
});

審核編輯 黃宇