更新README.en
This commit is contained in:
parent
f5487ca647
commit
1aba8c1014
91
README.en.md
Normal file
91
README.en.md
Normal file
@ -0,0 +1,91 @@
|
||||
<!-- Easy-FLV: Java RTSP/RTMP to FLV Converter -->
|
||||
# 📺 Easy-FLV: Java RTSP/RTMP to FLV Converter
|
||||
|
||||
[](https://github.com/javpower/easy-flv)
|
||||
[](https://github.com/javpower/easy-flv/issues)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
[](https://adoptopenjdk.net/)
|
||||
[](https://spring.io/projects/spring-boot)
|
||||
|
||||
## 🌟 About Easy-FLV
|
||||
Easy-FLV is a Java library that converts RTSP or RTMP video streams into FLV format for playback in web browsers. It provides an efficient, stable, and easily integrable solution for real-time video monitoring, live streaming, and video stream processing.
|
||||
|
||||
### Why Choose Easy-FLV?
|
||||
- **Efficient Conversion**: Quickly converts video streams to FLV format with no complex configuration required.
|
||||
- **Easy Integration**: Used as a Spring Boot Starter, it can be easily integrated into any Java project.
|
||||
- **Modern Browser Support**: Supports all major modern browsers without the need for additional plugins.
|
||||
- **Real-time Stream Processing**: Suitable for the conversion of real-time video streams, such as security monitoring and live broadcasting.
|
||||
|
||||
## 📄 Screenshots
|
||||
Below are screenshots of Easy-FLV in action:
|
||||
|
||||

|
||||

|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### Add Maven Dependency
|
||||
Include the following Maven dependency in your Spring Boot project:
|
||||
|
||||
```xml
|
||||
<dependency>
|
||||
<groupId>io.github.javpower</groupId>
|
||||
<artifactId>rtsp-converter-flv-spring-boot-starter</artifactId>
|
||||
<version>1.5.9.1</version>
|
||||
</dependency>
|
||||
```
|
||||
|
||||
### Implement Interface
|
||||
Create a service class that implements the `IOpenFLVService` interface to provide the stream address:
|
||||
|
||||
```java
|
||||
@Service
|
||||
public class RtspDataService implements IOpenFLVService {
|
||||
|
||||
@Override
|
||||
public String getUrl(Integer channel) {
|
||||
// Retrieve the RTSP stream address based on the channel
|
||||
return "rtsp://10.11.9.251:554/openUrl/16HV8mA";
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Configure YAML
|
||||
Configure Easy-FLV in your `application.yml`:
|
||||
|
||||
```yaml
|
||||
easy:
|
||||
flv:
|
||||
host: http://localhost:8200
|
||||
```
|
||||
|
||||
### Use Interface
|
||||
To get the converted stream address and play it in a browser:
|
||||
|
||||
- Conversion URL: `GET http://ip:port/get/flv/hls/stream_{channel}.flv`
|
||||
- Direct Browser Playback: `GET http://ip:port/flv/hls/stream_{channel}.flv`
|
||||
|
||||
### Direct Usage
|
||||
If you prefer not to implement an interface, you can directly encode the stream address and convert it:
|
||||
|
||||
```java
|
||||
public static void main(String[] args) throws UnsupportedEncodingException {
|
||||
String url = "rtsp://XXXXXXXX";
|
||||
String encodedUrl = java.net.URLEncoder.encode(url, "UTF-8");
|
||||
System.out.println("Encoded Stream URL: " + encodedUrl);
|
||||
}
|
||||
```
|
||||
|
||||
- Conversion URL: `GET http://ip:port/get/flv/hls/stream?url=EncodedAddress`
|
||||
- Direct Browser Playback: `GET http://ip:port/flv/hls/stream?url=EncodedAddress`
|
||||
|
||||
## 🛠️ Contribution
|
||||
Contributions of any kind are welcome, including but not limited to reporting bugs, submitting fixes, adding new features, and improving documentation.
|
||||
|
||||
## 📄 License
|
||||
Easy-FLV is released under the [Apache License 2.0](LICENSE).
|
||||
|
||||
## 📧 Contact
|
||||
- Email: [javpower@163.com](mailto:javpower@163.com)
|
||||
- GitHub: [https://github.com/javpower/easy-flv](https://github.com/javpower/easy-flv)
|
||||
- Gitee: [https://gitee.com/giteeClass/easy-flv](https://gitee.com/giteeClass/easy-flv)
|
Loading…
Reference in New Issue
Block a user