Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/XiaomaiTX/zeppos-timer
An accurate timer for ZeppOS. 一个适用于ZeppOS的准确的计时器
https://github.com/XiaomaiTX/zeppos-timer
Last synced: about 2 months ago
JSON representation
An accurate timer for ZeppOS. 一个适用于ZeppOS的准确的计时器
- Host: GitHub
- URL: https://github.com/XiaomaiTX/zeppos-timer
- Owner: XiaomaiTX
- License: mit
- Created: 2023-04-09T05:44:14.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-05-23T05:37:46.000Z (over 1 year ago)
- Last Synced: 2024-04-08T03:13:16.135Z (5 months ago)
- Language: JavaScript
- Homepage:
- Size: 6.84 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zeppos - zeppos-timer - An accurate timer for ZeppOS. (Libraries / Lib)
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
Table of Contents
## About The zeppos_timer.js
An accurate timer for ZeppOS.
ZeppTimer is a small and refined JavaScript class that provides an accurate timer for the ZeppOS system.
Here's why:
- In all versions of ZeppOS, there is a significant time discrepancy between the system's timer and the actual time due to underlying issues with the system. To achieve more accurate timing, I implemented a simple but effective approach to reduce timing errors and packaged it into ZeppTimer.
- Furthermore, in ZeppOS 2.x, the official approach to timer components was replaced with setTimeOut and cleanTimeOut, requiring logic adjustments when migrating ZeppOS 1.0 applications that use timers to ZeppOS 2.x and above. Using the ZeppTimer library can save developers the cost of migration.
Use the Usage to easily get started.
## Getting Started
The content here will help you get familiar with the program quickly.
### Prerequisites
Before using this library, please make sure you already have an understanding of ZeppOS applet development, you can refer to the [ZeppOS official documentation](https://docs.zepp.com/docs/intro/).
Also, you need a `code editor(Like Microsoft VSCode)` and `knowledge of JavaScript`.
### Installation
1. To use this library, you need to create a ZeppOS applet project first.refer to the [ZeppOS quick start](https://docs.zepp.com/docs/guides/quick-start/).
2. Please download the latest `zeppos_timer.js` file in the [Releases](https://github.com/XiaomaiTX/zeppos-timer/releases), and place `zeppos_timer.js` in the `libs/` directory of the root of the applet
3. Add a reference to zeppos_timer.js in the project
```js
import { ZeppTimer } from "../libs/zeppos_timer"; // Replace with the path to your zeppos_timer.js
```
At this point, you're ready to use the `zeppos_timer.js` library
## Usage
Then create a new instance of the class:
```javascript
const timer = new ZeppTimer(() => {
console.log("Tick!");
}, 1000);
```
The first argument to the `ZeppTimer` constructor is a callback function that will be called on each tick of the timer. The second argument is the time interval between ticks, in milliseconds.
To start the timer, call the `start` method:
```javascript
timer.start();
```
To stop the timer, call the `stop` method:
```javascript
timer.stop();
```
## Roadmap
- [x] Multi-language Support for README
- [x] English
- [x] 中文
See the [open issues](https://github.com/XiaomaiTX/zeppos-timer/issues) for a full list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Contact
XiaomaiTX - [email protected]
Project Link: [https://github.com/XiaomaiTX/zeppos-timer](https://github.com/XiaomaiTX/zeppos-timer)
[contributors-shield]: https://img.shields.io/github/contributors/XiaomaiTX/zeppos-timer.svg?style=for-the-badge
[contributors-url]: https://github.com/XiaomaiTX/zeppos-timer/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/XiaomaiTX/zeppos-timer.svg?style=for-the-badge
[forks-url]: https://github.com/XiaomaiTX/zeppos-timer/network/members
[stars-shield]: https://img.shields.io/github/stars/XiaomaiTX/zeppos-timer.svg?style=for-the-badge
[stars-url]: https://github.com/XiaomaiTX/zeppos-timer/stargazers
[issues-shield]: https://img.shields.io/github/issues/XiaomaiTX/zeppos-timer.svg?style=for-the-badge
[issues-url]: https://github.com/XiaomaiTX/zeppos-timer/issues
[license-shield]: https://img.shields.io/github/license/XiaomaiTX/zeppos-timer.svg?style=for-the-badge
[license-url]: https://github.com/XiaomaiTX/zeppos-timer/blob/master/LICENSE.txt