Merge branch 'release/2022.1.0'

.github/workflows/build.yml

@@ -17,11 +17,15 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - name: set up JDK 1.8
-        uses: actions/setup-java@v1
+      - name: Set up JDK
+        uses: actions/setup-java@v2
         with:
-          java-version: 1.8
+          distribution: 'adopt'
+          java-version: '11'
+          cache: 'gradle'
       - name: Copy gradle.properties
         run: cp gradle.properties.example gradle.properties
       - name: Build with Gradle
         run: ./gradlew build
+      - name: Lint Check
+        run: ./gradlew ktlintCheck

CHANGES.md

@@ -9,11 +9,36 @@
 - FIX
     - バグ修正
 
+## 2022.1.0
+
+- [CHANGE] スポットライトレガシーを削除する
+  - @enm10k
+- [UPDATE] libwebrtc を 96.4664.2.1 に上げる
+  - @enm10k
+- [UPDATE] 複数シグナリング URL の指定に対応する
+  - SoraMediaChannel に connectedSignalingEndpoint を追加する
+  - @enm10k
+- [UPDATE] redirect メッセージに対応する
+  - @enm10k
+- [UPDATE] dokka を 1.5.31 に上げる
+  - @miosakuma
+- [UPDATE] type: disconnect に reason を追加する
+  - @enm10k
+- [FIX] 視聴のみかつ H.264 した場合に接続できない問題についてのワークアラウンドを削除する
+  - SoraMediaOption.videoUpstreamContext が無く SoraMediaOption.videoDownstreamContext 
+    がある場合はコーデック指定に依らず、 DefaultVideoEncoderFactory を使用する
+  - @miosakuma
+- [FIX] libwebrtc の更新で発生するようになったサイマルキャストのクラッシュを修正する
+  - SimulcastVideoEncoderFactoryWrapper.kt の Fallback クラスが原因で java.lang.UnsupportedOperationException が発生していた
+  - 調査の結果、 Fallback クラスを削除できることがわかったので、その方向で修正した
+  - その過程で、 libwebrtc に適用している Android のサイマルキャスト対応のパッチを更新し、 SimulcastVideoEncoderFactory の fallback に null を指定できるようにした
+  - @enm10k
+
 ## 2021.3
 
-  - [UPDATE] libwebrtc を 93.4577.8.2 に上げる
+- [UPDATE] libwebrtc を 93.4577.8.2 に上げる
   - @miosakuma
-  - [FIX] stats メッセージに含まれる統計情報のフォーマットを修正する
+- [FIX] stats メッセージに含まれる統計情報のフォーマットを修正する
   - @enm10k
 
 ##  2021.2

README.md

@@ -1,7 +1,7 @@
 # Sora Android SDK
 
 [![Release](https://jitpack.io/v/shiguredo/sora-android-sdk.svg)](https://jitpack.io/#shiguredo/sora-android-sdk)
-[![libwebrtc](https://img.shields.io/badge/libwebrtc-m93.4577-blue.svg)](https://chromium.googlesource.com/external/webrtc/+/branch-heads/4515)
+[![libwebrtc](https://img.shields.io/badge/libwebrtc-m96.4664-blue.svg)](https://chromium.googlesource.com/external/webrtc/+/branch-heads/4515)
 [![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/shiguredo/sora-android-sdk.svg)](https://github.com/shiguredo/sora-android-sdk.svg)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
@@ -21,8 +21,8 @@ Please read https://github.com/shiguredo/oss before use.
 ## システム条件
 
 - Android 5 以降 (エミュレーターでの動作は保証しません)
-- Android Studio 4.2 以降
-- WebRTC SFU Sora 2021.1 以降
+- Android Studio 2020.3.1 以降
+- WebRTC SFU Sora 2021.2 以降
 
 ## サンプル
 
@@ -39,7 +39,7 @@ Please read https://github.com/shiguredo/oss before use.
 
 ```
 Copyright 2017, Lyo Kato <lyo.kato at gmail.com> (Original Author)
-Copyright 2017-2021, Shiguredo Inc.
+Copyright 2017-2022, Shiguredo Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

build.gradle

@@ -4,9 +4,9 @@ apply plugin: 'org.jetbrains.dokka'
 
 buildscript {
     ext.kotlin_version = '1.4.31'
-    ext.libwebrtc_version = '93.4577.8.2'
+    ext.libwebrtc_version = '96.4664.2.1'
 
-    ext.dokka_version = '0.10.1'
+    ext.dokka_version = '1.5.31'
 
     repositories {
         google()
@@ -18,10 +18,11 @@ buildscript {
         classpath 'com.android.tools.build:gradle:4.2.2'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlin_version}"
-        classpath 'org.ajoberstar.grgit:grgit-gradle:4.1.0'
+        classpath 'org.ajoberstar.grgit:grgit-gradle:4.1.1'
 
         classpath "org.jetbrains.dokka:dokka-gradle-plugin:${dokka_version}"
         classpath "com.github.ben-manes:gradle-versions-plugin:0.38.0"
+        classpath "org.jlleitschuh.gradle:ktlint-gradle:10.2.0"
     }
 }
 
@@ -40,7 +41,7 @@ task clean(type: Delete) {
 dependencyUpdates.resolutionStrategy = {
   componentSelection { rules ->
     rules.all { ComponentSelection selection ->
-      boolean rejected = ['alpha', 'beta', 'rc'].any { qualifier ->
+      boolean rejected = ['alpha', 'beta', 'rc', 'M'].any { qualifier ->
         selection.candidate.version ==~ /(?i).*[.-]${qualifier}[.\d-]*/
       }
       if (rejected) {

docs/CODE_FORMAT.md

@@ -0,0 +1,41 @@
+# コードのフォーマット
+
+Sora Android SDK ではソースコードの lint チェックとフォーマットが可能です。
+
+
+## ツール
+
+ktlint を利用します。 ktlint の Gradle プラグインを導入しているので、 Gradle プロジェクトを同期すればインストールされます。
+
+
+## 実行方法
+
+Android Studio ではビルド時に lint チェックとフォーマットが実行されます。コマンドラインでは Gradle のタスクとして実行できます。
+
+チェックのみ:
+
+```
+./gradlew ktlintCheck
+```
+
+フォーマット:
+
+```
+./gradlew ktlintFormat
+```
+
+ルール違反があった場合、詳細はコンソールの他に `sora-android-sdk/build/reports/ktlint` 以下のディレクトリにファイルとして出力されます。 `sora-android-sdk/main/src/main` 以下のソースコードの lint チェック結果は `ktlintMainSourceSetCheck/ktlintMainSourceSetCheck.txt` を参照してください。
+
+
+## ルール
+
+[Kotlin スタイルガイド](https://developer.android.com/kotlin/style-guide) に従います。 ktlint はデフォルトの設定で同スタイルに従うので、特に ktlint の設定はしていません。
+
+
+## 注意
+
+本リポジトリには Android Studio の設定が含まれています。設定を変更しないでください。
+
+設定内容は次の通りです。
+
+- Editor > Code Style > Kotlin > Imports にて、 `import` 文でのワイルドカードの使用を無効にします。

sora-android-sdk/build.gradle

@@ -3,6 +3,7 @@ apply plugin: 'com.github.dcendents.android-maven'
 
 apply plugin: 'kotlin-android'
 apply plugin: 'org.jetbrains.dokka'
+apply plugin: 'org.jlleitschuh.gradle.ktlint'
 
 group = 'com.github.shiguredo'
 
@@ -40,33 +41,46 @@ android {
     testOptions {
         unitTests.includeAndroidResources = true
     }
+}
 
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+    dependsOn("ktlintFormat")
     kotlinOptions {
-        jvmTarget = '1.8'
+        jvmTarget = "1.8"
     }
 }
 
-dokka {
-    outputFormat = 'javadoc'
-    outputDirectory = "$buildDir/dokka"
+dokkaHtml.configure {
+    // デフォルトの出力先は "${buildDir}/dokka". 変更したいときにコメントアウトを行う.
+    // outputDirectory.set(new File("${buildDir}/dokka"))
+    moduleName.set("sora-android-sdk")
+    // "dafault" を指定すると $USER_HOME/.cache/dokka を使用するとあるが実際には "${projectDir}/default" を見てしまうのでコメントアウトしている.
+    // cacheRoot.set(file("default"))
 
-    sourceSets {
-        configureEach {
-            moduleName = 'sora'
-            reportUndocumented true
-            includes = ['packages.md']
-            cacheRoot = "default"
-            disableAutoconfiguration = false
+    dokkaSourceSets {
+        named("main") {
+            reportUndocumented.set(true)
+            includes.from(files("packages.md"))
 
             sourceLink {
-                path = "sora-android-sdk/src/main/kotlin"
-                url = "https://github.com/shiguredo/sora-android-sdk/tree/master/sora-android-sdk/src/main/kotlin"
-                lineSuffix = "#L"
+                localDirectory.set(file("src/main/kotlin"))
+                remoteUrl.set(uri("https://github.com/shiguredo/sora-android-sdk/tree/master/sora-android-sdk/src/main/kotlin").toURL())
+                remoteLineSuffix.set("#L")
             }
         }
     }
 }
 
+ktlint {
+    version = "0.43.2"
+    android = false
+    outputToConsole = true
+    reporters {
+        reporter "checkstyle"
+    }
+    ignoreFailures = false
+}
+
 dependencies {
     api "com.github.shiguredo:shiguredo-webrtc-android:${libwebrtc_version}"
 

sora-android-sdk/packages.md

@@ -1,5 +1,5 @@
 # Module Sora Android SDK
 
-Sora Android SDK は [WebRTC SFU Sora](https://sora.shiguredo.jp) の Android クライアントアプリケーションを開発するためのライブラリです。
+Sora Android SDK は [WebRTC SFU Sora](https://sora.shiguredo.jp) の Android クライアントアプリケーションを開発するためのライブラリです.
 
-使い方は [Sora Android SDK ドキュメント](https://sora-android-sdk.shiguredo.jp/) を参照してください。
+使い方は [Sora Android SDK ドキュメント](https://sora-android-sdk.shiguredo.jp/) を参照してください.