Run Demo

ここでは、主にTencent Cloud IM Demo(iOS)を素早く実行する方法について説明します。

操作手順

手順1:アプリケーションの作成

1. IMコンソールにログインします。
説明:
アプリケーションをすでに所有している場合は、そのSDKAppIDを記録してからキー情報の取得を実行してください。 同じTencent Cloudのアカウントで、最大300個のIMアプリケーションを作成することができます。すでにアプリケーションが300個ある場合は、使用する必要のないアプリケーションを使用停止して削除すると、新しいアプリケーションを作成することができます。アプリケーションを削除した後、そのSDKAppIDに対応するすべてのデータとサービスは失われます。慎重に操作を行ってください。
2. 新しいアプリケーションの作成をクリックし、アプリケーションの作成のダイアログボックスにアプリケーション名を入力し、OKをクリックします。


3. 作成が完了すると、コンソールの概要ページで、作成したアプリケーションのステータス、サービスバージョン、SDKAppID、作成時間、タグおよび有効期限を確認できます。SDKAppID情報を記録してください。



ステップ2:キー情報の取得

1. 対象のアプリケーションカードをクリックし、アプリケーションの基本設定画面に移動します。


2. 基本情報セクションで、表示キーをクリックし、キー情報をコピーして保存します。
ご注意:
キー情報を適切に保管して、漏洩しないようにしてください。

ステップ3: Demo ソースコードのダウンロードおよび設定

1. IM Demoプロジェクトをダウンロードします。具体的なダウンロードアドレスについては、SDKダウンロードをご参照ください。
説明:
顔絵文字デザインの著作権を尊重するため、ダウンロードするDemoプロジェクトには大きな顔絵文字要素の切り取りが含まれておらず、自身のローカル顔絵文字パッケージを使用してコードを設定できます。IM Demoでの顔絵文字パッケージの不正使用は意匠権の侵害に当たる場合があります。
2. 所属する端末ディレクトリのプロジェクトを開き、対応するGenerateTestUserSigファイルを見付けます。 iOS パス:iOS/Demo/TUIKitDemo/Private/GenerateTestUserSig.h Mac パス:Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
3. GenerateTestUserSigファイルの関連パラメータを設定します。
SDKAPPID:手順1で取得した実際のアプリケーションSDKAppIDを設定してください。
SECRETKEY: ステップ2で取得した実際のキー情報を設定してください。


ご注意:
ここで言及するUserSigの取得方法は、クライアントコードにSECRETKEYを設定しますが、この手法のSECRETKEYは逆コンパイルによって逆クラッキングされやすく、キーがいったん漏洩すると、攻撃者はTencent Cloudトラフィックを盗用できるようになります。そのためこの手法は、ローカルのDemoクイックスタートおよび機能デバッグにのみ適しています。 UserSigの正しい発行方法は、UserSigの計算コードをサーバーに統合し、Appのインターフェース向けに提供します。 UserSigが必要なときは、Appから業務サーバーにリクエストを送信してダイナミックUserSigを取得します。詳細はサーバーでのUserSig新規作成をご参照ください。

手順4:コンパイル実行

ステップ3 でクローンしたDemoプロジェクトの対応ディレクトリにあるREADME.mdファイルをご参照ください。
1. 端末で次のコマンドを実行して、podのバージョンをチェックします。
pod --version
podが存在しない、またはpodのバージョンが1.7.5未満であるというプロンプトが表示された場合は、次のコマンドを実行して最新のpodをインストールします。
//gemソースの変更
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
//podのインストール
sudo gem install cocoapods -n /usr/local/bin
//複数のXcodeをインストールする場合は、次のコマンドを使用してXcodeのバージョンを選択してください(通常は最新のXcodeバージョンを選択)
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
//podローカルライブラリの更新
pod setup
2. 端末で次のコマンドを実行して、依存ライブラリをインストールします。
//iOS
cd iOS/TUIKitDemo
pod install
//Mac
cd Mac/TUIKitDemo
pod install
インストールに失敗した場合は、次のコマンドを実行してローカルのCocoaPodsリポジトリリストを更新します。
pod repo update
3. コンパイルして実行します。
iOSでiOS/TUIKitDemoフォルダに移動し、TUIKitDemo.xcworkspaceを開き、コンパイルして実行します。
Macで入Mac/TUIKitDemoフォルダに移動し、TUIKitDemo.xcworkspaceを開き、コンパイルして実行します。
ご注意:
Demoデフォルトでオーディオビデオ通話機能が統合されています。この機能が依存するAVのSDKは現在、シミュレーターをサポートしていないため、実際のマシンを使用してデバッグするかまたはDemoを実行してください。

高度な機能

関連ドキュメント