# Livestream

The UIKit now supports live stream posts so you can create and watch live streams.

### Installation

To enable live stream functionalities easily, we’ve provided `AmityUIKitLiveStream`, which is built on top of social.plus UIKit and social.plus SDK.

The plugin provides:

* `LiveStreamBroadcastViewController` to create and broadcast live stream posts
* `LiveStreamPlayerViewController` to watch live streams

The live stream plugin can be installed via Swift Package Manager with these steps:

1. In Xcode, select **File** > **Swift Packages** > **Add Package Dependency**.
2. Specify the Repository: <https://github.com/AmityCo/Amity-Social-Cloud-UIKit-LiveStream-iOS-SwiftPM>.
3. Select **Up to Next Major**, then click **Next**.
4. Select `AmityUIKitLiveStream, then` click **Finish**.

After successfully installing the plugin, you must override the live stream behaviors with these steps:

1. Create `AmityEventHandler` subclass, and override live stream functions.

   ```swift
   import UIKit
   import AVKit
   import AmityUIKit
   import AmitySDK
   import AmityUIKitLiveStream
   import AmityVideoPlayerKit

   class CustomEventHandler: AmityEventHandler {

       override func createLiveStreamPost(
           from source: AmityViewController,
           targetId: String?,
           targetType: AmityPostTargetType,
           destinationToUnwindBackAfterFinish: UIViewController
       ) {

           let broadcastVC =
               LiveStreamBroadcastViewController(client: AmityUIKitManager.client, targetId: targetId, targetType: targetType)
           broadcastVC.destinationToUnwindBackAfterFinish = destinationToUnwindBackAfterFinish
           broadcastVC.modalPresentationStyle = .fullScreen
           source.present(broadcastVC, animated: true, completion: nil)

       }

       override func openLiveStreamPlayer(from source: AmityViewController, postId: String, streamId: String) {

           let playerVC = LiveStreamPlayerViewController(streamIdToWatch: streamId)
           source.present(playerVC, animated: true, completion: nil)

       }

       override func openRecordedLiveStreamPlayer(from source: AmityViewController, postId: String, stream: AmityStream) {
           let player = AmityRecordedStreamPlayer(client: AmityUIKitManager.client, stream: stream)
           let playerViewController = AVPlayerViewController()
           playerViewController.player = player
           source.present(playerViewController, animated: true) { [weak player] in
               player?.play()
           }
       }

   }
   ```
2. Set the custom event handler for `social.plus UIKit`.

   ```
   AmityUIKitManager.set(eventHandler: CustomEventHandler())
   ```

### App Permissions

`LiveStreamBroadcastViewController` requires these permissions:

1. Camera Permission - to broadcast live stream video
2. Microphone Permission - to broadcast live stream audio

After `LiveStreamBroadcastViewController` is presented, it will prompt to ask permission automatically if needed. You must include these permission keys in your app’s Info.plist file:

1. `NSCameraUsageDescription`
2. `NSMicrophoneUsageDescription`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.social.plus/social-plus-uikit/uikit-3/ios/video-uikit/livestream.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.