Merge pull request #2725 from John-Lin/master
Add doc translation in zh-TW
This commit is contained in:
commit
8b3ed9067e
2 changed files with 83 additions and 0 deletions
36
docs-translations/zh-TW/api/power-monitor.md
Normal file
36
docs-translations/zh-TW/api/power-monitor.md
Normal file
|
@ -0,0 +1,36 @@
|
|||
# power-monitor
|
||||
|
||||
`power-monitor` 模組用來監看電源狀態的改變。你只能在主行程 (main process) 裡面使用。
|
||||
你應該要等到 `ready` 在 `app` 模組裡的事件被觸發 (emit),再使用這個模組。
|
||||
|
||||
舉例來說:
|
||||
|
||||
```javascript
|
||||
var app = require('app');
|
||||
|
||||
app.on('ready', function() {
|
||||
require('power-monitor').on('suspend', function() {
|
||||
console.log('The system is going to sleep');
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
## 事件 (Events)
|
||||
|
||||
`power-monitor` 模組會觸發 (emits) 以下幾個事件:
|
||||
|
||||
### 事件: 'suspend'
|
||||
|
||||
當系統進入 睡眠 (suspend) 時觸發。
|
||||
|
||||
### 事件: 'resume'
|
||||
|
||||
當系統 resume 時觸發。
|
||||
|
||||
### 事件: 'on-ac'
|
||||
|
||||
當系統改變使用交流電源 (AC) 時觸發。
|
||||
|
||||
### 事件: 'on-battery'
|
||||
|
||||
當系統改變使用電池店員時觸發。
|
47
docs-translations/zh-TW/api/power-save-blocker.md
Normal file
47
docs-translations/zh-TW/api/power-save-blocker.md
Normal file
|
@ -0,0 +1,47 @@
|
|||
# powerSaveBlocker
|
||||
|
||||
`power-save-blocker` 模組是用來防止系統進入省電模式 low-power (sleep) mode
|
||||
因此讓應用程式可以保持系統和螢幕的活躍 (active)。
|
||||
|
||||
舉例來說:
|
||||
|
||||
```javascript
|
||||
var powerSaveBlocker = require('power-save-blocker');
|
||||
|
||||
var id = powerSaveBlocker.start('prevent-display-sleep');
|
||||
console.log(powerSaveBlocker.isStarted(id));
|
||||
|
||||
powerSaveBlocker.stop(id);
|
||||
```
|
||||
|
||||
## 方法 (Methods)
|
||||
|
||||
`power-save-blocker` 模組有以下幾個方法:
|
||||
|
||||
### `powerSaveBlocker.start(type)`
|
||||
|
||||
* `type` String - Power save blocker type.
|
||||
* `prevent-app-suspension` - 防止一個應用程式進入睡眠 (suspended)。 將保持系統活躍,
|
||||
但允許螢幕被關閉。 使用案例:下載一個檔案或是播放音樂。
|
||||
* `prevent-display-sleep`- 防止螢幕進入睡眠。將保持系統和螢幕的活躍。
|
||||
使用案例:播放影片
|
||||
|
||||
當防止系統進入省電模式 low-power (sleep) mode 。 會回傳一個識別的整數來代表 power save blocker
|
||||
|
||||
**注意:** `prevent-display-sleep` 比 `prevent-app-suspension` 擁有較高的優先權。
|
||||
只有高的優先全力才會有效,換句話說 `prevent-display-sleep` 總是會優先於 `prevent-app-suspension`
|
||||
|
||||
例如,一個 API 呼叫 A 請求去做 `prevent-app-suspension`,而另外一個 B 請求去做 `prevent-display-sleep`
|
||||
`prevent-display-sleep` 將會被使用,直到 B 停止他的請求,`prevent-app-suspension` 才會被使用。
|
||||
|
||||
### `powerSaveBlocker.stop(id)`
|
||||
|
||||
* `id` Integer - power save blocker 會回傳 id 透過 `powerSaveBlocker.start`.
|
||||
|
||||
將指定的 id 停止 power save blocker
|
||||
|
||||
### `powerSaveBlocker.isStarted(id)`
|
||||
|
||||
* `id` Integer - power save blocker 會回傳 id 透過 `powerSaveBlocker.start`.
|
||||
|
||||
不管對應的 `powerSaveBlocker` 是否已經啟動,將會回傳一個布林值 (boolean)
|
Loading…
Reference in a new issue