waapi-rs 0.2.2

A Rust client for Wwise Authoring API (WAAPI), supporting async and sync usage
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! 订阅测试：对应 Python 的 client.subscribe(topic, callback) / handler.unsubscribe()
//!
//! 参考：https://github.com/audiokinetic/waapi-client-python
//! 需要本机开启 Wwise 并启用 Authoring API (Project > User Preferences... > Enable Wwise Authoring API)。
//! 运行方式：`cargo test`；若未开 Wwise 则部分测试会 skip。

use std::sync::atomic::{AtomicU32, Ordering};
use std::sync::Arc;
use std::time::Duration;
use tokio::time::timeout;
use waapi_rs::ak;
use waapi_rs::ak::wwise::ui::SELECTION_CHANGED;
use waapi_rs::WaapiClient;

#[tokio::test]
async fn test_subscribe_and_unsubscribe() {
    let client = match WaapiClient::connect().await {
        Ok(c) => c,
        Err(e) => {
            eprintln!("Skip: WAAPI not available ({e})");
            return;
        }
    };

    // 对应 Python: handler = client.subscribe("ak.wwise.ui.selectionChanged", callback)
    let handle = client
        .subscribe(SELECTION_CHANGED, None, |_kwargs| {})
        .await
        .expect("subscribe failed");

    // 短时等待（期间可能有事件触发回调）
    let _ = timeout(Duration::from_millis(800), tokio::time::sleep(Duration::from_millis(500)))
        .await;

    // 对应 Python: handler.unsubscribe()
    handle.unsubscribe().await.expect("unsubscribe failed");

    // 对应 Python: client.disconnect()
    client.disconnect().await;
}

#[tokio::test]
async fn test_subscribe_with_callback() {
    let client: WaapiClient = match WaapiClient::connect().await {
        Ok(c) => c,
        Err(e) => {
            eprintln!("Skip: WAAPI not available ({e})");
            return;
        }
    };

    // 对应 Python: handler = client.subscribe("ak.wwise.ui.selectionChanged", lambda object: print(...))
    let count = Arc::new(AtomicU32::new(0));
    let count_clone = Arc::clone(&count);
    let handler = client
        .subscribe(ak::wwise::ui::SELECTION_CHANGED, None, move |kwargs| {
            count_clone.fetch_add(1, Ordering::Relaxed);
            println!("[test] selectionChanged: {kwargs:?}");
        })
        .await
        .expect("subscribe failed");

    // 短暂等待，看是否收到事件（不强制）
    let _ = timeout(Duration::from_millis(500), async {
        tokio::time::sleep(Duration::from_millis(400)).await;
    })
    .await;

    // 对应 Python: handler.unsubscribe()
    handler.unsubscribe().await.expect("unsubscribe failed");

    // 对应 Python: client.disconnect()
    client.disconnect().await;

    let _n = count.load(Ordering::Relaxed);
}

#[tokio::test]
async fn test_subscribe_callback_drop_handle() {
    let client: WaapiClient = match WaapiClient::connect().await {
        Ok(c) => c,
        Err(e) => {
            eprintln!("Skip: WAAPI not available ({e})");
            return;
        }
    };

    let handler = client
        .subscribe(ak::wwise::ui::SELECTION_CHANGED, None, |kwargs| {
            println!("[test] selectionChanged (drop_handle): {kwargs:?}");
        })
        .await
        .expect("subscribe failed");

    // drop 句柄应自动取消订阅（与 Python 的 with 块结束类似）
    drop(handler);

    client.disconnect().await;
}