pash237 / lf.swift Goto Github PK

View Code? Open in Web Editor NEW

This project forked from shogo4405/haishinkit.swift

0.0 2.0 0.0 11.61 MB

Camera and Microphone streaming library via RTMP, HLS for iOS, macOS.

License: Other

Swift 98.32% Objective-C 0.41% Ruby 0.36% Batchfile 0.83% ActionScript 0.07%

lf.swift's Introduction

lf - lIVE fRAMEWORK

Camera and Microphone streaming library via RTMP, HLS for iOS, macOS.

Features

RTMP

HLS

HTTPService
HLS Publish

Others

Hardware acceleration for H264 video encoding/AAC audio encoding
Objectiv-C Bridging

Requirements

iOS 8.0+
macOS 10.11+
xcode 8.0+

Requirements Cocoa Keys

iOS10.0+

NSMicrophoneUsageDescription
NSCameraUsageDescription

Installation

CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
use_frameworks!

def import_pods
    pod 'lf', '~> 0.5.0'
end

target 'Your Target'  do
    platform :ios, '8.0'
    import_pods
end

RTMP Usage

Real Time Messaging Protocol (RTMP).

var rtmpConnection:RTMPConnection = RTMPConnection()
var rtmpStream:RTMPStream = RTMPStream(connection: rtmpConnection)
rtmpStream.attach(audio: AVCaptureDevice.defaultDevice(withMediaType: AVMediaTypeAudio))
rtmpStream.attach(camera: DeviceUtil.device(withPosition: .Back))

var lfView:LFView = LFView(frame: view.bounds)
lfView.videoGravity = AVLayerVideoGravityResizeAspectFill
lfView.attach(stream: rtmpStream)

// add ViewController#view
view.addSubview(lfView)

rtmpConnection.connect("rtmp://localhost/appName/instanceName")
rtmpStream.publish("streamName")
// if you want to record a stream.
// rtmpStream.publish("streamName", withType: .LocalRecord)

Settings

var rtmpStream:RTMPStream = RTMPStream(connection: rtmpConnection)
rtmpStream.captureSettings = [
    "fps": 30, // FPS
    "sessionPreset": AVCaptureSessionPresetMedium, // input video width/height
    "continuousAutofocus": false, // use camera autofocus mode
    "continuousExposure": false, //  use camera exposure mode
]
rtmpStream.audioSettings = [
    "muted": false, // mute audio
    "bitrate": 32 * 1024,
]
rtmpStream.videoSettings = [
    "width": 640, // video output width
    "height": 360, // video output height
    "bitrate": 160 * 1024, // video output bitrate
    // "dataRateLimits": [160 * 1024 / 8, 1], optional kVTCompressionPropertyKey_DataRateLimits property
    "profileLevel": kVTProfileLevel_H264_Baseline_3_1, // H264 Profile require "import VideoToolbox"
    "maxKeyFrameIntervalDuration": 2, // key frame / sec
]
// "0" means the same of input
rtmpStream.recorderSettings = [
    AVMediaTypeAudio: [
        AVFormatIDKey: Int(kAudioFormatMPEG4AAC),
        AVSampleRateKey: 0,
        AVNumberOfChannelsKey: 0,
    ],
    AVMediaTypeVideo: [
        AVVideoCodecKey: AVVideoCodecH264,
        AVVideoHeightKey: 0,
        AVVideoWidthKey: 0,
    ],
]

Authentication

var rtmpConnection:RTMPConnection = RTMPConnection()
rtmpConnection.connect("rtmp://username:password@localhost/appName/instanceName")

Screen Capture

// iOS
rtmpStream.attach(screen: ScreenCaptureSession())
// macOS
rtmpStream.attach(screen: AVCaptureScreenInput(displayID: CGMainDisplayID()))

HTTP Usage

HTTP Live Streaming (HLS). Your iPhone/Mac become a IP Camera. Basic snipet. You can see http://ip.address:8080/hello/playlist.m3u8

var httpStream:HTTPStream = HTTPStream()
httpStream.attach(camera: AVMixer.deviceWithPosition(.Back))
httpStream.attach(audio: AVCaptureDevice.defaultDeviceWithMediaType(AVMediaTypeAudio))
httpStream.publish("hello")

var lfView:LFView = LFView(frame: view.bounds)
lfView.attach(stream: httpStream)

var httpService:HTTPService = HTTPService(domain: "", type: "_http._tcp", name: "lf", port: 8080)
httpService.startRunning()
httpService.add(httpStream: httpStream)

// add ViewController#view
view.addSubview(lfView)