初始設定

!!! INFO "重要" 啟用SDK時應該要先完成初始設定，否則無法使用由此SDK提供的任何功能。

假設你需要在應用啟動時配置並啟動 ArctosLinks SDK，以下是如何正確地使用此方法的範例：

Swift


import ArctosLinks

func initializeArctosLinks() {
    let accessToken = "your_access_token_here"

    ArctosLinks.configure(with: accessToken) { result in
        switch result {
        case .success:
            print("ArctosLinks SDK successfully configured!")
            // 可以進行下一步操作，例如通知用戶或載入初始數據。
        case .failure(let error):
            print("Failed to configure ArctosLinks SDK: \(error.localizedDescription)")
            // 處理錯誤，例如顯示錯誤提示或重試配置。
        }
    }
}

Kotlin

import com.arctos.sdk.links.core.application.ArctosLinks

private fun initializeArctosLinks() {
    ArctosLinks.getInstance(Context).initialize(accessToken = accessToken)
        .onSuccess {            
            Log.d(TAG, "initialize onSuccess")            
        }.onFailure { initailzeFailure ->
            Log.d(TAG, "initialize onFailure ${initailzeFailure.message}")
        }
}

private suspend fun initializeArctosLinksMedia() {
    runCatching {
        ArctosLinks.getInstance(Context).mediaManager.initMedia(
            context = Context,
            lifecycleOwner = viewLifecycleOwner
        ).getOrThrow()
    }.onSuccess {
        Log.d(TAG, "initialize Media success")            
    }.onFailure {
        Log.d(TAG, "initialize Media failed ${it.message}")
    }        
}

c++

#include "arctos_qt.h"

void initializeArctosLinks(bool is_host, const std::string& name, const std::string& license) {
    auto& arctos_app = arctos::ArctosQt::getInstance();
    arctos_app.start();
    if (is_host) {
        // this method will emit loginFailed signal when failed
        arctos_app.loginAsHost(name, license);
    } else {
        // this method will emit loginFailed signal when failed
        arctos_app.loginAsParticipant(name, license);
    }
}

參數說明

accessToken: 這是一個用來啟動 ArctosLinks 的訪問通行令牌，通過申請License後取得。
使用accessToken 初始SDK，如果成功會回傳success,失敗則會回傳failed，並提供錯誤訊息。
Android 使用media功能前需要初始SDK media manager