【亲测免费】开源项目 `librestreaming` 使用教程

2026-01-17 08:16:53作者：瞿蔚英Wynne

项目介绍

librestreaming 是一个用于安卓平台的实时效果滤镜 RTMP 推流库。该项目利用安卓最新的 MediaCodec API 进行视频和音频编码，并使用流行的 C 库 librtmp（源码包含在内）进行 RTMP 推流。此外，它还提供了实现实时滤镜的能力。

项目快速启动

环境准备

安卓开发环境：确保你已经安装了 Android Studio 和必要的 SDK 工具。
依赖库：克隆项目到本地并导入到 Android Studio 中。

git clone https://github.com/lakeinchina/librestreaming.git

快速启动示例

以下是一个简单的示例代码，展示如何使用 librestreaming 进行实时推流：

import com.seu.magicfilter.utils.MagicFilterType;
import com.seu.magicfilter.filter.helper.FilterType;
import com.seu.magicfilter.filter.helper.MagicFilterFactory;

public class MainActivity extends AppCompatActivity {
    private RtmpCamera1 rtmpCamera1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        SurfaceView surfaceView = findViewById(R.id.surfaceView);
        rtmpCamera1 = new RtmpCamera1(surfaceView, new ConnectCheckerRtmp() {
            @Override
            public void onConnectionSuccessRtmp() {
                Toast.makeText(MainActivity.this, "连接成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onConnectionFailedRtmp(String reason) {
                Toast.makeText(MainActivity.this, "连接失败: " + reason, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onDisconnectRtmp() {
                Toast.makeText(MainActivity.this, "断开连接", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onAuthErrorRtmp() {
                Toast.makeText(MainActivity.this, "认证错误", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onAuthSuccessRtmp() {
                Toast.makeText(MainActivity.this, "认证成功", Toast.LENGTH_SHORT).show();
            }
        });

        rtmpCamera1.setFilter(MagicFilterFactory.getFilter(MagicFilterType.BEAUTY));
    }

    public void startStream(View view) {
        if (rtmpCamera1.isRecording() || rtmpCamera1.isStreaming()) {
            rtmpCamera1.stopRecord();
            rtmpCamera1.stopStream();
        } else {
            if (rtmpCamera1.prepareAudio() && rtmpCamera1.prepareVideo()) {
                rtmpCamera1.startStream("rtmp://your_rtmp_server_url");
            } else {
                Toast.makeText(this, "准备失败", Toast.LENGTH_SHORT).show();
            }
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        rtmpCamera1.stopStream();
    }
}